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 版或更新版本 |
| 標頭 |
|
| DLL |
|
另請參閱