共用方式為


OROpenKey 函式

在離線登錄區中開啟指定的登錄機碼。

語法

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

參數

控制碼 [in]

離線登錄區中開啟登錄機碼的控制碼。

lpSubKeyName [in, optional]

UNICODE 字串的指標,其中包含要開啟之登錄機碼的名稱。 此索引鍵必須是 Handle 參數所識別之索引鍵的子機碼。

索引鍵名稱不區分大小寫。

如果此參數為 Null 或空字串的指標,函式會傳回傳入的相同控制碼。 如果 Handle 參數指定的索引鍵是 hive 的根索引鍵,則函式會傳回ERROR_INVALID_PARAMETER。

如需詳細資訊,請參閱 登錄專案大小限制

phkResult [out]

接收已開啟索引鍵控制碼之變數的指標。 使用 ORCloseKey 函式,在您使用控制碼完成之後關閉金鑰。

傳回值

如果函式成功,傳回值會ERROR_SUCCESS。

如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來取得錯誤的泛型描述。

如果要傳回的控制碼會是 hive 根索引鍵的控制碼,則函式會傳回ERROR_INVALID_PARAMETER。

如果指定的索引鍵標示為已刪除,此函式會傳回ERROR_KEY_DELETED。

備註

OROpenKey函式無法用來在離線登錄區中開啟根機碼。 若要取得 Hive 根索引鍵的控制碼,請使用 OROpenHive 函式將 Hive 載入記憶體中。

規格需求

需求
可轉散發套件
Windows 離線登錄程式庫 1.0 版或更新版本
標頭
Offreg.h
DLL
Offreg.dll

另請參閱

ORCloseKey

ORCreateKey

ORDeleteKey

OROpenHive