Функция ORCreateHive
Создает автономный куст реестра, содержащий один пустой корневой ключ.
Синтаксис
DWORD ORCreateHive(
_Out_ PORHKEY phkResult
);
Параметры
-
phkResult [out]
-
Указывает на переменную для получения дескриптора корневого ключа только что созданного автономного куста реестра. Если куст не может быть создан, функция устанавливает для этого параметра значение NULL.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM.
Если для создания куста реестра недостаточно памяти, функция возвращает ERROR_NOT_ENOUGH_MEMORY.
Комментарии
Функция ORCreateHive создает пустой куст автономного реестра в памяти. Используйте функции ORCreateKey и ORSetValue , чтобы добавить ключи и задать их значения.
Требования
| Требование | Значение |
|---|---|
| Распространяемые компоненты |
Библиотека автономного реестра Windows версии 1.0 или более поздней |
| Заголовок |
|
| DLL |
|
См. также раздел