共用方式為


RegReplaceKeyA 函式 (winreg.h)

將備份登錄機碼的檔案及其所有子機碼取代為另一個檔案,如此一來,當系統下次啟動時,機碼和子機碼就會有儲存在新檔案中的值。

備份或還原系統狀態的應用程式,包括系統檔案和登錄區應該使用磁碟 區陰影複製服務 ,而不是登錄功能。

語法

LSTATUS RegReplaceKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           LPCSTR lpNewFile,
  [in]           LPCSTR lpOldFile
);

參數

[in] hKey

開啟登錄機碼的句柄。 RegCreateKeyExRegOpenKeyEx 函式會傳回此句柄,或者它可以是下列其中一個預先定義的索引鍵

HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS

[in, optional] lpSubKey

要取代其子機碼和值的登錄機碼名稱。 如果金鑰存在,它必須是 hKey 參數所識別之金鑰的子 機碼 。 如果子機碼不存在,則會建立它。 此參數可以是 Null

如果指定的子機碼不是Hive的根目錄, RegReplaceKey 會周遊Hive樹狀結構,直到遇到Hive根目錄為止,然後將該Hive的內容取代為 lpNewFile 所指定的數據文件內容。

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

[in] lpNewFile

具有登錄信息的檔名。 此檔案通常是使用 RegSaveKey 函式所建立。

[in] lpOldFile

接收所要取代之登錄信息的備份複本的檔名。

傳回值

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

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

備註

有兩種不同的登錄區檔格式。 先前的作業系統通常無法載入在目前操作系統上建立的登錄區。

lpNewFile 參數指定的檔案會保持開啟狀態,直到系統重新啟動為止。

如果 hKeyRegConnectRegistry 所傳回的句柄,則 lpNewFilelpOldFile 中指定的路徑會相對於遠端電腦。

呼叫進程必須具有登錄所在計算機上的SE_RESTORE_NAME和SE_BACKUP_NAME許可權。 如需詳細資訊,請參閱 以特殊許可權執行

注意

winreg.h 標頭會將 RegReplaceKey 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 winreg.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

RegConnectRegistry

RegDeleteKey

RegLoadKey

RegRestoreKey

RegSaveKey

登錄函式

登錄概觀