Fungsi RegLoadAppKeyA (winreg.h)

Artikel
08/27/2023

Memuat sarang registri yang ditentukan sebagai sarang aplikasi.

Sintaks

LSTATUS RegLoadAppKeyA(
  [in]  LPCSTR lpFile,
  [out] PHKEY  phkResult,
  [in]  REGSAM samDesired,
  [in]  DWORD  dwOptions,
        DWORD  Reserved
);

Parameter

[in] lpFile

Nama file hive. Hive ini harus dibuat dengan fungsi RegSaveKey atau RegSaveKeyEx . Jika file tidak ada, file hive kosong dibuat dengan nama yang ditentukan.

[out] phkResult

Arahkan ke handel untuk kunci akar sarang yang dimuat.

Satu-satunya cara untuk mengakses kunci di sarang adalah melalui handel ini. Registri akan mencegah aplikasi mengakses kunci di sarang ini menggunakan jalur absolut ke kunci. Akibatnya, tidak mungkin untuk menavigasi ke sarang ini melalui namespace registri.

[in] samDesired

Masker yang menentukan hak akses yang diminta untuk kunci akar yang dikembalikan. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

[in] dwOptions

Jika parameter ini REG_PROCESS_APPKEY, sarang tidak dapat dimuat lagi saat dimuat oleh pemanggil. Ini mencegah akses ke sarang registri ini oleh penelepon lain.

Reserved

Parameter ini dicadangkan.

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

Tidak seperti RegLoadKey, RegLoadAppKey tidak memuat sarang di bawah HKEY_LOCAL_MACHINE atau HKEY_USERS. Sebaliknya, sarang dimuat di bawah akar khusus yang tidak dapat dijumlahkan. Akibatnya, tidak ada cara untuk menghitung sarang yang saat ini dimuat oleh RegLoadAppKey. Semua operasi pada hive yang dimuat oleh RegLoadAppKey harus dilakukan relatif terhadap handel yang dikembalikan di phkResult.

Jika dua proses diperlukan untuk melakukan operasi pada sarang yang sama, setiap proses harus memanggil RegLoadAppKey untuk mengambil handel. Selama operasi RegLoadAppKey , registri akan memverifikasi apakah file telah dimuat. Jika telah dimuat, registri akan mengembalikan handel ke sarang yang dimuat sebelumnya daripada memuat ulang sarang.

Semua kunci di dalam sarang harus memiliki pendeskripsi keamanan yang sama, jika tidak, fungsi akan gagal. Deskriptor keamanan ini harus memberi penelepon akses yang ditentukan oleh parameter samDesired atau fungsi akan gagal. Anda tidak dapat menggunakan fungsi RegSetKeySecurity pada kunci apa pun di dalam sarang.

Di Windows 8 dan yang lebih baru, setiap proses dapat memanggil RegLoadAppKey untuk memuat beberapa sarang. Di Windows 7 dan yang lebih lama, setiap proses hanya dapat memuat satu sarang menggunakan RegLoadAppKey pada satu waktu.

Sarang apa pun yang dimuat menggunakan RegLoadAppKey secara otomatis dibongkar ketika semua handel ke kunci di dalam sarang ditutup menggunakan RegCloseKey.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Catatan

Header winreg.h mendefinisikan RegLoadAppKey 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

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

Lihat juga

RegSaveKey

Fungsi Registri

Apache Hive Registri

Bagikan melalui