OROpenHive 函式

  • 發行項

將指定的登錄區檔案載入記憶體，並驗證 Hive。

語法

DWORD OROpenHive(
  _In_  PCWSTR  lpHivePath,
  _Out_ PORHKEY phkResult
);

參數

lpHivePath [in]

Unicode 字串的指標，指定要載入記憶體中的登錄區檔名稱。 這可以是使用 ORSaveHive 函式儲存的 Hive 檔案，或使用 RegSaveKey 或 RegSaveKeyEx 函式建立。 檔案的大小必須小於 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函式是驗證登錄區的唯一離線登錄函式。 如果驗證失敗，則不會嘗試修復 Hive。

規格需求

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

另請參閱

ORCloseHive

ORCreateHive

ORSaveHive

RegSaveKey

RegSaveKeyEx