Системный реестр. Архитектура системного реестра, страница 5

RegDeleteKey                          • Windows 98   • Windows 2000

Описание

Функция RegDeleteKey удаляет подключ заданного ключа. В Windows NT/ 2000 эта функция не будет удалять подключи и не сможет быть выполнена при наличии подключей. А в Windows 9.x подключи с ее помощью удаляются.

Синтаксис

LONG RegDeleteKey(HKEY hKey, LPCTSTR IpszSubKey)

Параметры

hKey

HKEY: Дескриптор открытого ключа или любого из предопределенных ключей, перечисленных в табл. 19.1.

IpszSubKey

LPCTSTR: Указатель на строку, завершающуюся пустым символом и содержащую имя удаляемого ключа. Указанный ключ не должен содержать подключи, хотя может содержать значения. Эти значения удаляются вместе с ключом.

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

LONG: Если выполнение функции оказывается успешным, тогда возвращается значение ERROR_SUCCESS. В противном случае возвращается код ошибки.

Включаемыйфайл

winreg.h

См. также

RegCreateKeyEx, RegOpenKeyEx.

Пример

См. пример применения функции RegCreateKeyEx

RegDeleteValue                        * Windows 98   • Windows 2000

Описание

Функция RegDeleteValue удаляет значение из подключа.

Синтаксис

LONG RegDeleteValue(HKEY hKey, LPCTSTR IpszValueName)

Параметры

НКеу

HKEY: Дескриптор ключа, открытого с правом доступа KEY_SET VALUE,либо одного из предопределенных ключей, перечисленных в табл. 19.1.

Ipsz ValueName

LPCTSTR: Указатель на строку, завершающуюся нулевым символом и содержащую имя удаляемого значения. Если установлено значение NULL, тогда удаляется используемое по умолчанию значение.

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

LONG: Если выполнение функции оказывается успешным, тогда возвращается значение ERROR_SUCCESS. В противном случае возвращается код ошибки.

Включаемый файл

winreg.h

См. также

RegDeleteKey.

Пример

См. пример применения функции RegCreateKeyEx.

ReqDisablePredefinedCache              • Windows 98 • Windows 2000

Описание

Функция RegDisablePredefinedCache отключает таблицу предопределенных дескрипторов системного реестра в ключе HKEY_CURRENT_USER для текущего процесса. Любой доступ к ключу HKEY_CURRENT_USER после вызова этой функции приведет к выполнению операций открытия и закрытия по отношению к ключу с идентификатором защиты текущего процесса (HKEY_USERS\<SID текущего процесса>).

Синтаксис

LONGRegDisablePredefinedCache(VOID)

Параметры

Параметры отсутствуют.

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

LONG: Если выполнение функции оказывается успешным, тогда возвращается значение ERROR_SUCCESS. В противном случае возвращается код ошибки,

Включаемый файл

winreg.h

ReqNumKeyEx                           •  Windows 98   •  Windows 2000

Описание

Функция   RegNumKeyEx перечисляет подключи указанного открытого ключа системного реестра. Эта функция при каждом вызове выбирает информацию об одном ключе. Для перечисления подключей в приложении следует первоначально вызвать функцию RegNumKeyEx с установленным значением 0 параметра dwlndex. Затем в приложении должно выполняться приращение параметра dwlndex и вызов функции RegNumKeyEx до тех пор, пока не будет возвращено значение  ERROR_NO_MORE_ITEMS (ошибка в связи с отсутствием каких-либо дополнительных элементов). Перечисление ключей в приложении может быть также выполнено снизу вверх благодаря установке в параметре dwlndex индекса последнего под-ключа при первом вызове рассматриваемой функции и последующем отрицательном приращении индекса до тех пор, пока не будет перечислен подключ с индексом 0. Функция RegNumKeyEx используется также для выборки индекса последнего подключа.

Синтаксис

LONG RegNumKeyEx(HKEY hKey, DWORD dwlndex, LPTSTR IpszName, LPDWORD IpcdwName. LPDWORD IpdwReserved, LPTSTR IpszClassName, LPDWORD IpcdwClassName, PFILETIME pftLastChanged)

Параметры

hKey

HKEY: Открытый ключ, подключи которого подлежат перечислению. Это может быть открытый ключ или один из предопределенных ключей, приведенных в табл. 19.1.

dwlndex

DWORD: Индекс подключа, используемый для доступа к нему. Для доступа к первому подключу следует установить значение 0 в счетчике под-ключей. А для перечисления подключей по дереву необходимо выполнять приращение указанного счетчика до тех пор, пока при очередном вызове не будет возвращено значение ERROR_NO_MORE_ITEMS.

IpszName

LPTSTR: Указатель на буфер, в который поступает имя перечисляемого подключа. Это имя является не полностью определенным именем ключа,