w32api - Справочник по Windows API
Найти:
На:





Функция RegEnumKeyEx перечисляет подключи указанного открытого ключа реестра. Функция возвращает имя одного подключа при каждом вызове. В отличии от функции RegEnumKey, эта функция возвращает имя класса подключа и время последней модификации.

LONG RegEnumKeyEx(
    HKEY hKey,	// дескриптор перечисляемого ключа
    DWORD dwIndex,	// индекс перечисляемого подключа 
    LPTSTR lpName,	// адрес буфера для имени подключа
    LPDWORD lpcbName,	// адрес размера буфера подключа 
    LPDWORD lpReserved,	// зарезервировано 
    LPTSTR lpClass,	// адрес буфера для имени класса 
    LPDWORD lpcbClass,	//  адрес размера буфера для имени класса
    PFILETIME lpftLastWriteTime 	// адрес для времени последней записи ключа
);
Параметры:

hKey Идентифицирует уже открытый ключ или один из предопределенных дескрипторов:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
HKEY_CURRENT_CONFIG

Возвращаемые ключи относительны ключу, указанному в hKey.
dwIndex Указывает индекс затребованного подключа. Его значение должно быть нулевым для первого вызова функции RegEnumKeyEx и инкрементироваться для последующих вызовов.

Поскольку подключи не упорядочены, любой новый подключ будет иметь произвольный индекс. Это означает, что функция может возвращать подключи в любом порядке.
lpName Адрес буфера, в который возвращается имя подключа, включая нулевой заканчивающий символ. Эта функция копирует в буфер только имя подключа, а не полную иерархию ключа.
cbName Указывает размер, в символах, буфера на который адресуется параметр lpName. Для определения требуемого размера буфера, используйте функцию RegQueryInfoKey, чтобы определить наибольший размер имени подключа, указанного в параметре hKey. Максимальный требуемый размер буфера это (MAX_PATH + 1) символов.
lpReserved Зарезервировано. Должно быть NULL.
lpClass Адрес буфера, куда функция возвращает имя класса перечисляемого подключа. Этот параметр может быть равен NULL, если класс не требуется.
lpcbClass Адрес переменной, в которой указан размер буфера для имени класса. Размер должен учытывать и завершающий нулевой символ. Когда вункция возвращается, lpcbClass содержит количество символов, записанных в буфер. Вовращенный размер не учитывает нулевой символ. Этот параметр может быть NULL, если только lpClass тоже NULL.
lpftLastWriteTime Адрес переменной, в которую возвращается время последенй записи для перечисляемого подключа.

Возвращаемые значения:

Если функция успешна, возвращается значение ERROR_SUCCESS.

При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.

Замечания:

Для перечисления подключей, приложение должно при первом вызове функции RegEnumKeyEx установить параметр dwIndex в нулевое значение. Затем, приложение должно инкрементировать параметр dwIndex и вызывать функцию RegEnumKeyEx до тех пор, пока не будет более подключей (пока функция не вернет ERROR_NO_MORE_ITEMS).

Приложение может, также, установить индекс на последний ключ при первом вызове функции и затем декрементировать индекс до подключа с индексом 0. Для получения индекса последнего подключа, используйте RegQueryInfoKey.

Пока приложение использует функцию RegEnumKeyEx, оно не должно вызывать любые другие функции реестра, которые могут изменить запрашиваемый ключ.

Ключ, указанный в параметре hKey, должен быть открытым с доступом KEY_ENUMERATE_SUB_KEYS (доступ KEY_READ включает в себя и доступ KEY_ENUMERATE_SUB_KEYS). Для открытия ключа используйте функцию RegCreateKeyEx или RegOpenKeyEx.

Смотрите также:

RegCreateKeyEx, RegDeleteKey, RegEnumKey, RegOpenKeyEx, RegQueryInfoKey



Hosted by uCoz