ФУНКЦИЯ OROpenHive
Загружает указанный файл куста реестра в память и проверяет куст.
Синтаксис
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
Параметры
-
lpHivePath [in]
-
Указатель на строку Юникода, указывающую имя файла куста реестра, загружаемого в память. Это может быть файл hive, который был сохранен с помощью функции ORSaveHive или создан с помощью функции RegSaveKey или RegSaveKeyEx . Размер файла должен быть менее 4 ГБ, а вызывающий объект должен иметь FILE_READ_DATA доступ к файлу. Дополнительные сведения см. в разделе Безопасность файлов и права доступа.
-
phkResult [out]
-
Указатель на переменную, которая получает дескриптор корневого ключа загруженного автономного куста реестра. Если не удается открыть файл куста реестра или проверка завершается сбоем, функция устанавливает для этого параметра значение NULL.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение представляет собой ненулевой код ошибки, определенный в Winerror.h. Чтобы получить общее описание ошибки, можно использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM. Возможные коды ошибок:
- Если файл пуст или превышает 4 ГБ, функция возвращает ERROR_BADDB.
- Если вызывающий объект не имеет необходимых прав доступа для открытия файла, функция возвращает ERROR_ACCESS_DENIED.
- Если куст реестра не проходит проверку, функция возвращает ERROR_NOT_REGISTRY_FILE.
Комментарии
Функция OROpenHive является единственной функцией автономного реестра, которая проверяет куст реестра. Если проверка завершается неудачно, попытка восстановить куст не предпринимается.
Требования
| Требование | Значение |
|---|---|
| Распространяемые компоненты |
Библиотека автономного реестра Windows версии 1.0 или более поздней |
| Заголовок |
|
| DLL |
|
См. также раздел