struktur TRUSTEE_A (accctrl.h)

Artikel
03/11/2023

Struktur TRUSTEE mengidentifikasi akun pengguna, akun grup, atau sesi masuk tempat entri kontrol akses (ACE) berlaku. Struktur dapat menggunakan nama atau pengidentifikasi keamanan (SID) untuk mengidentifikasi wali amanat.

Fungsi kontrol akses, seperti SetEntriesInAcl dan GetExplicitEntriesFromAcl, menggunakan struktur ini untuk mengidentifikasi akun masuk yang terkait dengan kontrol akses atau informasi kontrol audit dalam struktur EXPLICIT_ACCESS .

Sintaks

typedef struct _TRUSTEE_A {
  struct _TRUSTEE_A          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPSTR              ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_A *pObjectsAndName;
  };
  LPCH                       ptstrName;
} TRUSTEE_A, *PTRUSTEE_A, TRUSTEEA, *PTRUSTEEA;

Anggota

pMultipleTrustee

Penunjuk ke struktur TRUSTEE yang mengidentifikasi akun server yang dapat meniru pengguna yang diidentifikasi oleh anggota ptstrName . Anggota ini saat ini tidak didukung dan harus NULL.

MultipleTrusteeOperation

Nilai jenis enumerasi MULTIPLE_TRUSTEE_OPERATION . Saat ini, anggota ini harus NO_MULTIPLE_TRUSTEE.

TrusteeForm

Nilai dari jenis enumerasi TRUSTEE_FORM yang menunjukkan jenis data yang ditunjukkan oleh anggota ptstrName .

TrusteeType

Nilai dari jenis enumerasi TRUSTEE_TYPE yang menunjukkan apakah wali adalah akun pengguna, akun grup, atau jenis akun yang tidak diketahui.

ptstrName

Penunjuk ke buffer yang mengidentifikasi wali dan, secara opsional, berisi informasi tentang ACE khusus objek. Jenis data tergantung pada nilai anggota TrusteeForm .

Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TRUSTEE_IS_NAME	Penunjuk ke string yang dihentikan null yang berisi nama wali.
TRUSTEE_IS_OBJECTS_AND_NAME	Penunjuk ke struktur OBJECTS_AND_NAME yang berisi nama wali dan nama jenis objek dalam ACE khusus objek.
TRUSTEE_IS_OBJECTS_AND_SID	Penunjuk ke struktur OBJECTS_AND_SID yang berisi SID wali amanat dan GUID jenis objek dalam ACE khusus objek.
TRUSTEE_IS_SID	Arahkan ke SID wali amanat.

pSid

pObjectsAndSid

pObjectsAndName

Keterangan

Nama wali dapat memiliki salah satu format berikut:

Nama yang sepenuhnya memenuhi syarat, seperti "g:\remotedir\abc".
Akun domain, seperti "domain1\xyz".
Salah satu nama grup yang telah ditentukan sebelumnya, seperti "SEMUA ORANG" atau "TAMU".

Salah satu nama khusus berikut.

Nama	Makna
GRUP PEMBUAT	SID CREATOR_GROUP adalah SID yang digunakan dalam ACE yang dapat diwariskan. Ketika objek baru dibuat, sistem mengganti SID ini dengan SID grup utama pengguna yang membuat objek.
CREATOR OWNER	SID CREATOR_OWNER adalah SID yang digunakan dalam ACE yang dapat diwariskan. Ketika objek baru dibuat, sistem mengganti SID ini dengan SID pengguna yang membuat objek.
CURRENT_USER	Pemilik utas atau proses panggilan.

Trustee SID dapat berupa SID pengguna atau grup apa pun. Ini juga bisa menjadi salah satu SID universal yang terkenal. Untuk informasi selengkapnya, lihat Pengidentifikasi Keamanan.

Catatan

Header accctrl.h mendefinisikan TRUSTEE_ 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