Fungsi InitializeSecurityDescriptor (securitybaseapi.h)

Artikel
08/25/2023

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