struktur OBJECTS_AND_NAME_A (accctrl.h)

Artikel
02/26/2024

Struktur OBJECTS_AND_NAME berisi string yang mengidentifikasi wali berdasarkan nama dan string tambahan yang mengidentifikasi jenis objek entri kontrol akses khusus objek (ACE).

Sintaks

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

Anggota

ObjectsPresent

Menunjukkan apakah anggota ObjectTypeName dan InheritedObjectTypeName berisi string. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
ACE_OBJECT_TYPE_PRESENT 0x1	Anggota ObjectTypeName berisi string.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Anggota InheritedObjectTypeName berisi string.

ObjectType

Menentukan nilai dari enumerasi SE_OBJECT_TYPE yang menunjukkan jenis objek.

ObjectTypeName

Penunjuk ke string yang dihentikan null yang mengidentifikasi jenis objek yang diterapkan ACE.

String ini harus berupa nama tampilan LDAP yang valid dalam skema Direktori Aktif.

InheritedObjectTypeName

Penunjuk ke string yang dihentikan null yang mengidentifikasi jenis objek yang dapat mewarisi ACE.

String ini harus berupa nama tampilan LDAP yang valid dalam skema Direktori Aktif.

Jika bit ACE_INHERITED_OBJECT_TYPE_PRESENT tidak diatur dalam anggota ObjectsPresent , anggota InheritedObjectTypeName 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.

ptstrName

Penunjuk ke string yang dihentikan null yang berisi nama wali.

Keterangan

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

Catatan

Header accctrl.h mendefinisikan OBJECTS_AND_NAME_ sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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