struktur TOKEN_PRIVILEGES (winnt.h)

Artikel
03/04/2024

Struktur TOKEN_PRIVILEGES berisi informasi tentang sekumpulan hak istimewa untuk token akses.

Sintaks

typedef struct _TOKEN_PRIVILEGES {
  DWORD               PrivilegeCount;
  LUID_AND_ATTRIBUTES Privileges[ANYSIZE_ARRAY];
} TOKEN_PRIVILEGES, *PTOKEN_PRIVILEGES;

Anggota

PrivilegeCount

Ini harus diatur ke jumlah entri dalam array Hak Istimewa .

Privileges[ANYSIZE_ARRAY]

Menentukan array struktur LUID_AND_ATTRIBUTES . Setiap struktur berisi LUID dan atribut hak istimewa. Untuk mendapatkan nama hak istimewa yang terkait dengan LUID, panggil fungsi LookupPrivilegeName , meneruskan alamat LUID sebagai nilai parameter lpLuid .

Penting Konstanta ANYSIZE_ARRAY didefinisikan sebagai 1 di header publik Winnt.h. Untuk membuat array ini dengan lebih dari satu elemen, Anda harus mengalokasikan memori yang cukup agar struktur mempertimbangkan elemen tambahan.

Atribut hak istimewa dapat menjadi kombinasi dari nilai berikut.

Nilai	Makna
SE_PRIVILEGE_ENABLED	Hak istimewa diaktifkan.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	Hak istimewa diaktifkan secara default.
SE_PRIVILEGE_REMOVED	Digunakan untuk menghapus hak istimewa. Untuk detailnya, lihat AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	Hak istimewa digunakan untuk mendapatkan akses ke objek atau layanan. Bendera ini digunakan untuk mengidentifikasi hak istimewa yang relevan dalam set yang diteruskan oleh aplikasi klien yang mungkin berisi hak istimewa yang tidak perlu.

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 (sertakan Windows.h)