Поделиться через


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

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

Синтаксис

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

См. также раздел

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

Функции реестра

Обзор реестра