Функция RegCloseKey (winreg.h)

Статья
08/27/2023

Закрывает дескриптор для указанного раздела реестра.

Синтаксис

LSTATUS RegCloseKey(
  [in] HKEY hKey
);

Параметры

[in] hKey

Дескриптор закрытого ключа. Дескриптор должен быть открыт функцией RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, RegOpenKeyTransacted или RegConnectRegistry .

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

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

Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, отличный от нуля, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.

Дескриптор для указанного ключа не следует использовать после его закрытия, так как он больше не будет допустимым. Маркеры ключей не следует оставлять открытыми дольше, чем это необходимо.

Функция RegCloseKey не обязательно записывает сведения в реестр перед возвратом; Для сброса кэша на жесткий диск может потребоваться до нескольких секунд. Если приложение должно явно записывать сведения реестра на жесткий диск, оно может использовать функцию RegFlushKey . Однако RegFlushKey использует множество системных ресурсов и должен вызываться только при необходимости.

Примеры

Пример см. в разделе Удаление ключа с подразделами.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winreg.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll