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 載入記憶體中。