Fungsi RegLoadAppKeyW (winreg.h)

Memuat sarang registri yang ditentukan sebagai sarang aplikasi.

Sintaksis

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

Parameter

[in] lpFile

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

[out] phkResult

Penunjuk 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 layanan 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 pemanggil lain.

Reserved

Parameter ini dicadangkan.

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

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 deskriptor keamanan yang sama, jika tidak, fungsi akan gagal. Deskriptor keamanan ini harus memberi pemanggil 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 sekaligus.

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.

Persyaratan

Lihat juga

RegSaveKey

Fungsi Registri

Apache Hive Registri