Fungsi InitializeSecurityDescriptor (securitybaseapi.h)

Fungsi InitializeSecurityDescriptor menginisialisasi deskriptor keamanan baru.

Sintaks

BOOL InitializeSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in]  DWORD                dwRevision
);

Parameter

[out] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang diinisialisasi fungsi.

[in] dwRevision

Tingkat revisi untuk ditetapkan ke deskriptor keamanan. Parameter ini harus SECURITY_DESCRIPTOR_REVISION.

Menampilkan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi InitializeSecurityDescriptor menginisialisasi deskriptor keamanan dalam format absolut , bukan format relatif mandiri .

Fungsi InitializeSecurityDescriptor menginisialisasi deskriptor keamanan agar tidak memiliki daftar kontrol akses sistem (SACL), tidak ada daftar kontrol akses diskresi (DACL), tidak ada pemilik, tidak ada grup utama, dan semua bendera kontrol yang diatur ke FALSE (NULL). Dengan demikian, kecuali untuk tingkat revisinya, itu kosong.

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Membuat Deskriptor Keamanan untuk Objek Baru.

Persyaratan

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

Lihat juga

GetSecurityDescriptorControl

GetSecurityDescriptorDacl

GetSecurityDescriptorGroup

GetSecurityDescriptorLength

GetSecurityDescriptorOwner

GetSecurityDescriptorSacl

IsValidSecurityDescriptor

Access Control tingkat rendah

Fungsi Access Control tingkat rendah

SECURITY_DESCRIPTOR

SetSecurityDescriptorDacl

SetSecurityDescriptorGroup

SetSecurityDescriptorOwner

SetSecurityDescriptorSacl