struktur TOKEN_GROUPS (winnt.h)

Artikel
08/27/2023

Struktur TOKEN_GROUPS berisi informasi tentang pengidentifikasi keamanan grup (SID) dalam token akses.

Sintaks

typedef struct _TOKEN_GROUPS {
  DWORD              GroupCount;
#if ...
  SID_AND_ATTRIBUTES *Groups[];
#else
  SID_AND_ATTRIBUTES Groups[ANYSIZE_ARRAY];
#endif
} TOKEN_GROUPS, *PTOKEN_GROUPS;

Anggota

GroupCount

Menentukan jumlah grup dalam token akses.

Groups[*]

Menentukan array struktur SID_AND_ATTRIBUTES yang berisi sekumpulan SID dan atribut yang sesuai.

Anggota Atribut dari struktur SID_AND_ATTRIBUTES dapat memiliki nilai berikut.

Nilai	Makna
SE_GROUP_ENABLED 0x00000004L	SID diaktifkan untuk pemeriksaan akses. Ketika sistem melakukan pemeriksaan akses, sistem memeriksa entri kontrol akses (ACE) yang diizinkan akses dan ditolak akses yang berlaku untuk SID. SID tanpa atribut ini diabaikan selama pemeriksaan akses kecuali atribut SE_GROUP_USE_FOR_DENY_ONLY diatur.
SE_GROUP_ENABLED_BY_DEFAULT 0x00000002L	SID diaktifkan secara default.
SE_GROUP_INTEGRITY 0x00000020L	SID adalah SID integritas wajib.
SE_GROUP_INTEGRITY_ENABLED 0x00000040L	SID diaktifkan untuk pemeriksaan integritas wajib.
SE_GROUP_LOGON_ID 0xC0000000L	SID adalah SID masuk yang mengidentifikasi sesi masuk yang terkait dengan token akses.
SE_GROUP_MANDATORY 0x00000001L	SID tidak dapat menghapus atribut SE_GROUP_ENABLED oleh panggilan ke fungsi AdjustTokenGroups . Namun, Anda dapat menggunakan fungsi CreateRestrictedToken untuk mengonversi SID wajib menjadi SID khusus tolak.
SE_GROUP_OWNER 0x00000008L	SID mengidentifikasi akun grup yang pengguna tokennya adalah pemilik grup, atau SID dapat ditetapkan sebagai pemilik token atau objek.
SE_GROUP_RESOURCE 0x20000000L	SID mengidentifikasi grup domain-lokal.
SE_GROUP_USE_FOR_DENY_ONLY 0x00000010L	SID adalah SID khusus tolak dalam token terbatas. Ketika sistem melakukan pemeriksaan akses, sistem memeriksa ACE yang ditolak akses yang berlaku untuk SID; ini mengabaikan ACE yang diizinkan akses untuk SID. Jika atribut ini diatur, SE_GROUP_ENABLED tidak diatur, dan SID tidak dapat diaktifkan kembali.

Groups[ANYSIZE_ARRAY]

Menentukan array struktur SID_AND_ATTRIBUTES yang berisi sekumpulan SID dan atribut yang sesuai.

Anggota Atribut dari struktur SID_AND_ATTRIBUTES dapat memiliki nilai berikut.

Nilai	Makna
SE_GROUP_ENABLED 0x00000004L	SID diaktifkan untuk pemeriksaan akses. Ketika sistem melakukan pemeriksaan akses, sistem memeriksa entri kontrol akses (ACE) yang diizinkan akses dan ditolak akses yang berlaku untuk SID. SID tanpa atribut ini diabaikan selama pemeriksaan akses kecuali atribut SE_GROUP_USE_FOR_DENY_ONLY diatur.
SE_GROUP_ENABLED_BY_DEFAULT 0x00000002L	SID diaktifkan secara default.
SE_GROUP_INTEGRITY 0x00000020L	SID adalah SID integritas wajib.
SE_GROUP_INTEGRITY_ENABLED 0x00000040L	SID diaktifkan untuk pemeriksaan integritas wajib.
SE_GROUP_LOGON_ID 0xC0000000L	SID adalah SID masuk yang mengidentifikasi sesi masuk yang terkait dengan token akses.
SE_GROUP_MANDATORY 0x00000001L	SID tidak dapat menghapus atribut SE_GROUP_ENABLED oleh panggilan ke fungsi AdjustTokenGroups . Namun, Anda dapat menggunakan fungsi CreateRestrictedToken untuk mengonversi SID wajib menjadi SID khusus tolak.
SE_GROUP_OWNER 0x00000008L	SID mengidentifikasi akun grup yang pengguna tokennya adalah pemilik grup, atau SID dapat ditetapkan sebagai pemilik token atau objek.
SE_GROUP_RESOURCE 0x20000000L	SID mengidentifikasi grup domain-lokal.
SE_GROUP_USE_FOR_DENY_ONLY 0x00000010L	SID adalah SID khusus tolak dalam token terbatas. Ketika sistem melakukan pemeriksaan akses, sistem memeriksa ACE yang ditolak akses yang berlaku untuk SID; ini mengabaikan ACE yang diizinkan akses untuk SID. Jika atribut ini diatur, SE_GROUP_ENABLED tidak diatur, dan SID tidak dapat diaktifkan kembali.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winnt.h (sertakan Windows.h)