struktur OBJECTS_AND_NAME_A (accctrl.h)

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

Sintaksis

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 ObjectTypeName dan InheritedObjectTypeName anggota berisi string. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Arti
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 null-terminated yang mengidentifikasi jenis objek yang diterapkan ACE.

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

Jika bit ACE_INHERITED_OBJECT_TYPE_PRESENT tidak diatur di anggota ObjectsPresent , anggota ObjectTypeName diabaikan.

InheritedObjectTypeName

Penunjuk ke string null-terminated 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 turunan 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 warisan yang ditempatkan pada objek anak.

ptstrName

Penunjuk ke string null-terminated yang berisi nama wali.

Komentar

Anggota ptstrName dari struktur TRUSTEE_A adalah penunjuk ke struktur OBJECTS_AND_NAME_A jika TrusteeFormTRUSTEE_IS_OBJECTS_AND_NAME. Ini memungkinkan fungsi seperti SetEntriesInAcl dan GetExplicitEntriesFromAcl untuk menyimpan informasi ACE khusus objek di Trustee anggota struktur EXPLICIT_ACCESS.

Nota

Header accctrl.h mendefinisikan OBJECTS_AND_NAME_ sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	accctrl.h

Lihat juga

ACE_HEADER

EXPLICIT_ACCESS

GetExplicitEntriesFromAcl

OBJECTS_AND_SID

SE_OBJECT_TYPE

SetEntriesInAcl

TRUSTEE_A