RegRestoreKeyA 函式 (winreg.h)
讀取指定檔案中的登錄資訊,並將它複製到指定的機碼上。 此登錄資訊的格式可能是機碼和多個子機碼層級。
備份或還原系統狀態的應用程式,包括系統檔案和登錄區應該使用磁碟 區陰影複製服務 ,而不是登錄功能。
語法
LSTATUS RegRestoreKeyA(
[in] HKEY hKey,
[in] LPCSTR lpFile,
[in] DWORD dwFlags
);
參數
[in] hKey
開啟登錄機碼的句柄。 RegCreateKeyEx 或 RegOpenKeyEx 函式會傳回此句柄。 它也可以是下列其中一個 預先定義的索引鍵:
HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIG HKEY_CURRENT_USER HKEY_LOCAL_MACHINEHKEY_USERS此機碼中包含的任何資訊及其子系索引鍵,會由 lpFile 參數所指向之檔案中的資訊覆寫。
[in] lpFile
具有登錄信息的檔名。 此檔案通常是使用 RegSaveKey 函式所建立。
[in] dwFlags
指出金鑰或金鑰還原方式的旗標。 此參數可以是下列其中一個值。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標,以取得錯誤的一般描述。
備註
有兩種不同的登錄區檔格式。 先前的作業系統通常無法載入在目前操作系統上建立的登錄區。
如果開啟 hKey 參數的任何子機碼, RegRestoreKey 會失敗。
呼叫進程必須具有登錄所在計算機上的SE_RESTORE_NAME和SE_BACKUP_NAME許可權。 如需詳細資訊,請參閱 以特殊許可權執行。
不論檔案中最上層索引鍵的名稱為何,此函式都會以屬於檔案中最上層索引鍵的索引鍵和值取代指定索引鍵下方的索引鍵和值。 例如, hKey 可能會識別具有子機碼 B 和 C 的金鑰 A,而 lpFile 參數則指定包含具有子機碼 Y 和 Z 之金鑰 X 的檔案。呼叫 RegRestoreKey 之後,登錄會包含具有子機碼 Y 和 Z 的機碼 A。A 的值專案會由 X 的值專案取代。
lpFile 所指定檔案中的新資訊會覆寫 hKey 參數所指定的密鑰內容,但金鑰名稱除外。
如果 hKey 代表遠端電腦中的金鑰, lpFile 所描述的路徑會相對於遠端電腦。
注意
winreg.h 標頭會將 RegRestoreKey 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winreg.h (包含 Windows.h) |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |