OROpenHive 函数
将指定的注册表配置单元文件加载到内存中并验证配置单元。
语法
DWORD OROpenHive(
_In_ PCWSTR lpHivePath,
_Out_ PORHKEY phkResult
);
parameters
-
lpHivePath [in]
-
指向 Unicode 字符串的指针，该字符串指定要加载到内存中的注册表配置单元文件的名称。 这可以是使用 ORSaveHive 函数保存或使用 RegSaveKey 或 RegSaveKeyEx 函数创建的 hive 文件。 文件的大小必须小于 4 GB，并且调用方必须具有对该文件FILE_READ_DATA访问权限。 有关详细信息，请参阅 文件安全性和访问权限。
-
phkResult [out]
-
指向变量的指针，该变量接收加载的脱机注册表配置单元的根键的句柄。 如果无法打开注册表配置单元文件或验证失败，函数会将此参数设置为 NULL。
返回值
如果函数成功，则返回值为 ERROR_SUCCESS。
如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与 FORMAT_MESSAGE_FROM_SYSTEM 标志一起使用，以获取错误的泛型说明。 可能的错误代码包括以下内容：
- 如果文件为空或大于 4 GB，则函数返回ERROR_BADDB。
- 如果调用方没有打开文件所需的访问权限，则函数将返回ERROR_ACCESS_DENIED。
- 如果注册表配置单元验证失败，函数将返回ERROR_NOT_REGISTRY_FILE。
备注
OROpenHive 函数是验证注册表配置单元的唯一脱机注册表函数。 如果验证失败，则不会尝试修复配置单元。
要求
| 要求 | 值 |
|---|---|
| 可再发行组件 |
Windows 脱机注册表库版本 1.0 或更高版本 |
| 标头 |
|
| DLL |
|
请参阅