OROpenKey 函数

在脱机注册表配置单元中打开指定的注册表项。

语法

DWORD OROpenKey(
  _In_     ORHKEY  Handle,
  _In_opt_ PCWSTR  lpSubKeyName,
  _Out_    PORHKEY phkResult
);

处理 [in]

脱机注册表配置单元中打开的注册表项的句柄。

lpSubKeyName [in， optional]

指向 UNICODE 字符串的指针，该字符串包含要打开的注册表项的名称。此键必须是 由 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 函数将配置单元加载到内存中。