Fungsi SeQueryInformationToken (ntifs.h)

Artikel
03/08/2023

Rutinitas SeQueryInformationToken mengambil jenis informasi tertentu tentang token akses. Proses panggilan harus memiliki hak akses yang sesuai untuk mendapatkan informasi.

Sintaks

NTSTATUS SeQueryInformationToken(
  [in]  PACCESS_TOKEN           Token,
  [in]  TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out] PVOID                   *TokenInformation
);

Parameter

[in] Token

Penunjuk ke token akses tempat informasi akan diambil. Jika TokenInformationClass diatur ke TokenSource, handel harus memiliki akses TOKEN_QUERY_SOURCE. Untuk semua nilai TokenInformationClass lainnya, handel harus memiliki akses TOKEN_QUERY.

[in] TokenInformationClass

Nilai dari jenis enumerasi TOKEN_INFORMATION_CLASS yang mengidentifikasi jenis informasi yang akan diambil.

[out] TokenInformation

Jika STATUS_SUCCESS dikembalikan, TokenInformation menerima penunjuk ke lokasi yang berisi alamat buffer yang menyimpan informasi yang diminta. Format buffer informasi ini tergantung pada nilai TokenInformationClass, seperti yang ditunjukkan dalam tabel berikut. Ketahuilah bahwa buffer dialokasikan oleh SeQueryInformationToken dari kumpulan halaman. Buffer ini pada akhirnya harus dikosongkan oleh pemanggil dengan menggunakan ExFreePool.

Nilai	Deskripsi
TokenDefaultDacl	Buffer menerima struktur TOKEN_DEFAULT_DACL yang berisi DACL default untuk objek yang baru dibuat.
TokenGroups	Buffer menerima struktur TOKEN_GROUPS yang berisi akun grup yang terkait dengan token.
TokenImpersonationLevel	Buffer menerima nilai SECURITY_IMPERSONATION_LEVEL yang menunjukkan tingkat peniruan token. Jika token akses bukan token peniruan identitas, panggilan ke SeQueryInformationToken gagal.
TokenOwner	Buffer menerima struktur TOKEN_OWNER yang berisi pengidentifikasi keamanan pemilik default (SID) untuk objek yang baru dibuat.
TokenPrimaryGroup	Buffer menerima struktur TOKEN_PRIMARY_GROUP yang berisi SID grup utama default untuk objek yang baru dibuat.
TokenPrivileges	Buffer menerima struktur TOKEN_PRIVILEGES yang berisi hak istimewa token.
TokenSessionId	Buffer menerima nilai DWORD (bukan penunjuk) yang menunjukkan pengidentifikasi sesi Layanan Terminal yang terkait dengan token. Jika token dikaitkan dengan sesi konsol Terminal Server, pengidentifikasi sesi adalah nol. Pengidentifikasi sesi bukan nol menunjukkan sesi klien Layanan Terminal. Di lingkungan Layanan non-Terminal, pengidentifikasi sesi adalah nol.
TokenSource	Buffer menerima struktur TOKEN_SOURCE yang berisi sumber token. TOKEN_QUERY_SOURCE akses diperlukan untuk mengambil informasi ini.
TokenStatistics	Buffer menerima struktur TOKEN_STATISTICS yang berisi berbagai statistik token.
TokenType	Buffer menerima nilai TOKEN_TYPE yang menunjukkan apakah token adalah token utama atau peniruan.
TokenUser	Buffer menerima struktur TOKEN_USER yang berisi akun pengguna token.
TokenIntegrityLevel	Buffer menerima nilai DWORD (bukan penunjuk) yang menentukan tingkat integritas token.

Mengembalikan nilai

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Panggilan ke SeQueryInformationToken berhasil.
STATUS_INVALID_INFO_CLASS	Nilai yang tidak valid disediakan untuk TokenInformationClass.

Keterangan

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL