struktur OBJECTS_AND_SID (accctrl.h)

Artikel
02/26/2024

Struktur OBJECTS_AND_SID berisi pengidentifikasi keamanan (SID) yang mengidentifikasi trustee dan GUID yang mengidentifikasi jenis objek entri kontrol akses khusus objek (ACE).

Sintaks

typedef struct _OBJECTS_AND_SID {
  DWORD ObjectsPresent;
  GUID  ObjectTypeGuid;
  GUID  InheritedObjectTypeGuid;
  SID   *pSid;
} OBJECTS_AND_SID, *POBJECTS_AND_SID;

Anggota

ObjectsPresent

Menunjukkan apakah anggota ObjectTypeGuid dan InheritedObjectTypeGuid berisi GUID. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
ACE_OBJECT_TYPE_PRESENT 0x1	Anggota ObjectTypeGuid berisi GUID.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Anggota InheritedObjectTypeGuid berisi GUID.

ObjectTypeGuid

Struktur GUID yang mengidentifikasi jenis objek, kumpulan properti, atau properti yang dilindungi oleh ACE. Jika ACE ini diwariskan, GUID mengidentifikasi jenis objek, kumpulan properti, atau properti yang dilindungi oleh ACE yang diwariskan. GUID ini harus menjadi pengidentifikasi skema yang valid dalam skema Direktori Aktif.

Jika bit ACE_OBJECT_TYPE_PRESENT tidak diatur dalam anggota ObjectsPresent , anggota ObjectTypeGuid diabaikan, dan ACE melindungi objek tempat ACL ditetapkan.

InheritedObjectTypeGuid

Struktur GUID yang mengidentifikasi jenis objek yang dapat mewarisi ACE. GUID ini harus menjadi pengidentifikasi skema yang valid dalam skema Direktori Aktif.

Jika bit ACE_INHERITED_OBJECT_TYPE_PRESENT tidak diatur dalam anggota ObjectsPresent , anggota InheritedObjectTypeGuid diabaikan, dan semua jenis objek anak dapat mewarisi ACE. Jika tidak, hanya jenis objek yang ditentukan yang dapat mewarisi ACE. Dalam kedua kasus, pewarisan juga dikendalikan oleh bendera warisan dalam struktur ACE_HEADER serta oleh perlindungan apa pun terhadap pewarisan yang ditempatkan pada objek anak.

pSid

Penunjuk ke SID wali yang diterapkan ACE.

Keterangan

Anggota ptstrName dari struktur TRUSTEE dapat menjadi penunjuk ke struktur OBJECTS_AND_SID . Ini memungkinkan fungsi seperti SetEntriesInAcl dan GetExplicitEntriesFromAcl untuk menyimpan informasi ACE khusus objek di anggota Trustee dari struktur EXPLICIT_ACCESS .

Saat Anda menggunakan struktur ini dalam panggilan ke SetEntriesInAcl, ObjectTypeGuid dan InheritedObjectTypeGuid harus menjadi pengidentifikasi skema yang valid dalam skema Direktori Aktif. Sistem tidak memverifikasi GUID; mereka digunakan apa adanya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	accctrl.h