Fungsi RegReplaceKeyW (winreg.h)

Artikel
08/27/2023

Mengganti file yang mendukung kunci registri dan semua subkuntangnya dengan file lain, sehingga ketika sistem berikutnya dimulai, kunci dan subkuntang akan memiliki nilai yang disimpan dalam file baru.

Aplikasi yang mencadangkan atau memulihkan status sistem termasuk file sistem dan sarang registri harus menggunakan Layanan Menyalin Bayangan Volume alih-alih fungsi registri.

Sintaks

LSTATUS RegReplaceKeyW(
  [in]           HKEY    hKey,
  [in, optional] LPCWSTR lpSubKey,
  [in]           LPCWSTR lpNewFile,
  [in]           LPCWSTR lpOldFile
);

Parameter

[in] hKey

Handel ke kunci registri terbuka. Handel ini dikembalikan oleh fungsi RegCreateKeyEx atau RegOpenKeyEx , atau dapat menjadi salah satu kunci yang telah ditentukan sebelumnya berikut:

HKEY_CLASSES_ROOTHKEY_LOCAL_MACHINE HKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_USERS

[in, optional] lpSubKey

Nama kunci registri yang subkuntang dan nilainya akan diganti. Jika kunci ada, kunci harus berupa subkunji kunci yang diidentifikasi oleh parameter hKey . Jika subkunci tidak ada, subkunci akan dibuat. Parameter ini bisa NULL.

Jika subkuntang yang ditentukan bukan akar sarang, RegReplaceKey melintasi struktur pohon hive sampai menemukan akar sarang, maka itu menggantikan konten sarang tersebut dengan konten file data yang ditentukan oleh lpNewFile.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

[in] lpNewFile

Nama file dengan informasi registri. File ini biasanya dibuat dengan menggunakan fungsi RegSaveKey .

[in] lpOldFile

Nama file yang menerima salinan cadangan informasi registri yang diganti.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Keterangan

Ada dua format file sarang registri yang berbeda. Sarang registri yang dibuat pada sistem operasi saat ini biasanya tidak dapat dimuat oleh yang sebelumnya.

File yang ditentukan oleh parameter lpNewFile tetap terbuka sampai sistem dimulai ulang.

Jika hKey adalah handel yang dikembalikan oleh RegConnectRegistry, maka jalur yang ditentukan dalam lpNewFile dan lpOldFile relatif terhadap komputer jarak jauh.

Proses panggilan harus memiliki hak SE_RESTORE_NAME dan SE_BACKUP_NAME pada komputer tempat registri berada. Untuk informasi selengkapnya, lihat Menjalankan dengan Hak Istimewa Khusus.

Catatan

Header winreg.h mendefinisikan RegReplaceKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll