struktur TRUSTEE_A (accctrl.h)

Artikel
11/20/2024

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, gunakan struktur ini untuk mengidentifikasi akun masuk yang terkait dengan kontrol akses atau informasi kontrol audit dalam struktur EXPLICIT_ACCESS.

Sintaksis

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 amanat 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	Arti
TRUSTEE_IS_NAME	Penunjuk ke untai (karakter) nullyang dihentikan yang berisi nama wali amanat.
TRUSTEE_IS_OBJECTS_AND_NAME	Penunjuk ke struktur OBJECTS_AND_NAME yang berisi nama wali amanat 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	Penunjuk ke SID wali amanat.

pSid

pObjectsAndSid

pObjectsAndName

Komentar

Nama wali bisa 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 "EVERYONE" atau "GUEST".

Salah satu nama khusus berikut.

Nama	Arti
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.
PEMILIK PEMBUAT	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.

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

Nota

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