Fungsi RegGetKeySecurity (winreg.h)

Artikel
03/08/2023

Fungsi RegGetKeySecurity mengambil salinan deskriptor keamanan yang melindungi kunci registri terbuka yang ditentukan.

Sintaks

LSTATUS RegGetKeySecurity(
  [in]            HKEY                 hKey,
  [in]            SECURITY_INFORMATION SecurityInformation,
  [out, optional] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, out]       LPDWORD              lpcbSecurityDescriptor
);

Parameter

[in] hKey

Handel ke kunci terbuka untuk mengambil deskriptor keamanan.

[in] SecurityInformation

Nilai SECURITY_INFORMATION yang menunjukkan informasi keamanan yang diminta.

[out, optional] pSecurityDescriptor

Penunjuk ke buffer yang menerima salinan deskriptor keamanan yang diminta.

[in, out] lpcbSecurityDescriptor

Penunjuk ke variabel yang menentukan ukuran, dalam byte, dari buffer yang diarahkan oleh parameter pSecurityDescriptor . Ketika fungsi kembali, variabel berisi jumlah byte yang ditulis ke buffer.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan 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

Jika buffer yang ditentukan oleh parameter pSecurityDescriptor terlalu kecil, fungsi mengembalikan ERROR_INSUFFICIENT_BUFFER dan parameter lpcbSecurityDescriptor berisi jumlah byte yang diperlukan untuk deskriptor keamanan yang diminta.

Untuk membaca pemilik, grup, atau daftar kontrol akses diskresi (DACL) dari deskriptor keamanan kunci, proses panggilan harus diberikan READ_CONTROL akses ketika handel dibuka. Untuk mendapatkan akses READ_CONTROL, pemanggil harus menjadi pemilik kunci atau DACL kunci harus memberikan akses.

Untuk membaca daftar kontrol akses sistem (SACL) dari deskriptor keamanan, proses panggilan harus diberikan ACCESS_SYSTEM_SECURITY akses saat kunci dibuka. Cara yang benar untuk mendapatkan akses ini adalah dengan mengaktifkan hak istimewa SE_SECURITY_NAME dalam token pemanggil saat ini, buka handel untuk akses ACCESS_SYSTEM_SECURITY, lalu nonaktifkan hak istimewa.

Persyaratan


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