struktur SECURITY_DESCRIPTOR (winnt.h)

Artikel
03/04/2024

Struktur SECURITY_DESCRIPTOR berisi informasi keamanan yang terkait dengan objek. Aplikasi menggunakan struktur ini untuk mengatur dan mengkueri status keamanan objek.

Karena format internal deskriptor keamanan dapat bervariasi, sebaiknya aplikasi tidak memodifikasi struktur SECURITY_DESCRIPTOR secara langsung. Untuk membuat dan memanipulasi deskriptor keamanan, gunakan fungsi yang tercantum di Lihat Juga.

Sintaks

typedef struct _SECURITY_DESCRIPTOR {
  BYTE                        Revision;
  BYTE                        Sbz1;
  SECURITY_DESCRIPTOR_CONTROL Control;
  PSID                        Owner;
  PSID                        Group;
  PACL                        Sacl;
  PACL                        Dacl;
} SECURITY_DESCRIPTOR, *PISECURITY_DESCRIPTOR;

Anggota

Revision

Sbz1

Control

Owner

Group

Sacl

Dacl

Keterangan

Deskriptor keamanan menyertakan informasi yang menentukan komponen keamanan objek berikut:

Pengidentifikasi keamanan pemilik (SID)
SID grup utama
Daftar kontrol akses diskresi (DACL)
Daftar kontrol akses sistem (SACL)
Kualifikasi untuk item sebelumnya

Beberapa fungsi yang menggunakan struktur SECURITY_DESCRIPTOR mengharuskan struktur ini diselaraskan pada batas penunjuk yang valid dalam memori. Batas-batas ini bervariasi tergantung pada jenis prosesor yang digunakan. Fungsi alokasi memori seperti malloc dan LocalAlloc mengembalikan pointer yang diratakan dengan benar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Header	winnt.h (termasuk Windows.h)