Fungsi RegLoadKeyA (winreg.h)

Artikel
11/20/2024

Membuat subkunci di bawah HKEY_USERS atau HKEY_LOCAL_MACHINE dan memuat data dari sarang registri yang ditentukan ke dalam subkunci tersebut.

Aplikasi yang mencadangkan atau memulihkan status sistem termasuk file sistem dan sarang registri harus menggunakan Volume Shadow Copy Service alih-alih fungsi registri.

Sintaksis

LSTATUS RegLoadKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey,
  [in]           LPCSTR lpFile
);

Parameter

[in] hKey

Handel ke kunci tempat subkunci akan dibuat. Ini bisa menjadi handel yang dikembalikan oleh panggilan ke RegConnectRegistry, atau salah satu handel yang telah ditentukan sebelumnya berikut:

HKEY_LOCAL_MACHINEHKEY_USERS Fungsi ini selalu memuat informasi di bagian atas hierarki registri. Nilai penanganan HKEY_CLASSES_ROOT dan HKEY_CURRENT_USER tidak dapat ditentukan untuk parameter ini, karena mewakili subset nilai penanganan HKEY_LOCAL_MACHINE dan HKEY_USERS.

[in, optional] lpSubKey

Nama kunci yang akan dibuat di bawah hKey. Subkuntah ini adalah tempat informasi pendaftaran dari file akan dimuat.

Nama kunci tidak peka huruf besar/kecil.

Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

[in] lpFile

Nama file yang berisi data registri. File ini harus berupa file lokal yang dibuat dengan fungsi RegSaveKey. Jika file ini tidak ada, file dibuat dengan nama yang ditentukan.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

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

Komentar

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

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

Proses panggilan harus memiliki hak istimewa SE_RESTORE_NAME dan SE_BACKUP_NAME pada komputer tempat registri berada. Untuk informasi selengkapnya, lihat Berjalan dengan Hak Istimewa Khusus. Untuk memuat sarang tanpa memerlukan hak istimewa ini, gunakan fungsi RegLoadAppKey.

Nota

Header winreg.h mendefinisikan RegLoadKey sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

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

Lihat juga

RegConnectRegistry

regDeleteKey

RegLoadAppKey

RegReplaceKey

RegRestoreKey

RegSaveKey

RegUnLoadKey

Fungsi Registri

Apache Hive Registri

Bagikan melalui