Функция OROpenKey
Открывает указанный раздел реестра в автономном кусте реестра.
Синтаксис
DWORD OROpenKey(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpSubKeyName,
_Out_ PORHKEY phkResult
);
Параметры
-
Дескриптор [в]
-
Дескриптор открытого раздела реестра в автономном кусте реестра.
-
lpSubKeyName [in, необязательно]
-
Указатель на строку ЮНИКОДа, содержащую имя открываемого раздела реестра. Этот ключ должен быть подразделом ключа, определяемого параметром Handle .
В именах ключей регистр не учитывается.
Если этот параметр имеет значение NULL или указатель на пустую строку, функция возвращает тот же дескриптор, который был передан. Если ключ, заданный параметром Handle , является корневым ключом куста, функция возвращает ERROR_INVALID_PARAMETER.
Дополнительные сведения см. в разделе Ограничения размера элементов реестра.
-
phkResult [out]
-
Указатель на переменную, получающую дескриптор открытого ключа. Используйте функцию ORCloseKey , чтобы закрыть ключ после завершения использования дескриптора.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой код ошибки, отличный от нуля, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.
Если возвращаемый дескриптор будет дескриптором корневого ключа куста, функция возвращает ERROR_INVALID_PARAMETER.
Если указанный ключ помечен как удаленный, эта функция возвращает ERROR_KEY_DELETED.
Комментарии
Функцию OROpenKey нельзя использовать для открытия корневого раздела в автономном кусте реестра. Чтобы получить дескриптор корневого ключа куста, используйте функцию OROpenHive для загрузки куста в память.
Требования
| Требование | Значение |
|---|---|
| Распространяемые компоненты |
Библиотека автономного реестра Windows версии 1.0 или более поздней |
| Заголовок |
|
| DLL |
|
См. также раздел