struktur TRUSTEE_A (accctrl.h)
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 |
---|---|
|
Penunjuk ke string yang dihentikan null yang berisi nama wali. |
|
Penunjuk ke struktur OBJECTS_AND_NAME yang berisi nama wali dan nama jenis objek dalam ACE khusus objek. |
|
Penunjuk ke struktur OBJECTS_AND_SID yang berisi SID wali amanat dan GUID jenis objek dalam ACE khusus objek. |
|
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.
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 |