RegReplaceKeyA 函式（winreg.h）

發行項
11/20/2024

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

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

語法

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

參數

[in] hKey

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

HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS

[in, optional] lpSubKey

要取代其子機碼和值的登錄機碼名稱。如果索引鍵存在，它必須是由 hKey 參數所識別的索引鍵子機碼。如果子機碼不存在，則會建立子機碼。此參數可以是 NULL。

如果指定的子機碼不是Hive的根目錄，RegReplaceKey 周遊 hive 樹狀結構，直到遇到 Hive 根目錄為止，它會以 lpNewFile 所指定的數據檔內容取代該 Hive 的內容。

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

[in] lpNewFile

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

[in] lpOldFile

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

傳回值

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

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

言論

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

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

如果 hKey 是 RegConnectRegistry 所傳回的句柄，則 lpNewFile 中指定的路徑和 lpOldFile 相對於遠端電腦。

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

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winreg.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll