struktur TOKEN_STATISTICS (winnt.h)

Artikel
03/04/2024

Struktur TOKEN_STATISTICS berisi informasi tentang token akses. Aplikasi dapat mengambil informasi ini dengan memanggil fungsi GetTokenInformation .

Sintaks

typedef struct _TOKEN_STATISTICS {
  LUID                         TokenId;
  LUID                         AuthenticationId;
  LARGE_INTEGER                ExpirationTime;
  TOKEN_TYPE                   TokenType;
  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel;
  DWORD                        DynamicCharged;
  DWORD                        DynamicAvailable;
  DWORD                        GroupCount;
  DWORD                        PrivilegeCount;
  LUID                         ModifiedId;
} TOKEN_STATISTICS, *PTOKEN_STATISTICS;

Anggota

TokenId

Menentukan pengidentifikasi unik lokal (LUID) yang mengidentifikasi instans objek token ini.

AuthenticationId

Menentukan LUID yang ditetapkan ke sesi yang diwakili token ini. Mungkin ada banyak token yang mewakili satu sesi masuk.

ExpirationTime

Menentukan waktu kedaluwarsa token ini. Waktu kedaluwarsa untuk token akses saat ini tidak didukung.

TokenType

Menentukan jenis enumerasi TOKEN_TYPE yang menunjukkan apakah token adalah token utama atau peniruan.

ImpersonationLevel

Menentukan jenis enumerasi SECURITY_IMPERSONATION_LEVEL yang menunjukkan tingkat peniruan token. Anggota ini hanya valid jika TokenType adalah TokenImpersonation.

DynamicCharged

Menentukan jumlah, dalam byte, memori yang dialokasikan untuk menyimpan perlindungan default dan pengidentifikasi grup utama.

DynamicAvailable

Menentukan bagian memori yang dialokasikan untuk menyimpan perlindungan default dan pengidentifikasi grup utama yang belum digunakan. Nilai ini dikembalikan sebagai hitungan byte bebas.

GroupCount

Menentukan jumlah pengidentifikasi keamanan grup tambahan (SID) yang disertakan dalam token.

PrivilegeCount

Menentukan jumlah hak istimewa yang disertakan dalam token.

ModifiedId

Menentukan LUID yang berubah setiap kali token dimodifikasi. Aplikasi dapat menggunakan nilai ini sebagai pengujian apakah konteks keamanan telah berubah sejak terakhir kali digunakan.

Persyaratan

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