Fungsi GetTokenInformation (securitybaseapi.h)
Fungsi GetTokenInformation mengambil jenis informasi tertentu tentang token akses. Proses panggilan harus memiliki hak akses yang sesuai untuk mendapatkan informasi.
Untuk menentukan apakah pengguna adalah anggota grup tertentu, gunakan fungsi CheckTokenMembership . Untuk menentukan keanggotaan grup untuk token kontainer aplikasi, gunakan fungsi CheckTokenMembershipEx .
Sintaks
BOOL GetTokenInformation(
[in] HANDLE TokenHandle,
[in] TOKEN_INFORMATION_CLASS TokenInformationClass,
[out, optional] LPVOID TokenInformation,
[in] DWORD TokenInformationLength,
[out] PDWORD ReturnLength
);
Parameter
[in] TokenHandle
Handel ke token akses tempat informasi diambil. Jika TokenInformationClass menentukan TokenSource, handel harus memiliki akses TOKEN_QUERY_SOURCE. Untuk semua nilai TokenInformationClass lainnya, handel harus memiliki akses TOKEN_QUERY.
[in] TokenInformationClass
Menentukan nilai dari jenis TOKEN_INFORMATION_CLASS yang dijumlahkan untuk mengidentifikasi jenis informasi yang diambil fungsi. Setiap penelepon yang memeriksa TokenIsAppContainer dan memintanya mengembalikan 0 juga harus memverifikasi bahwa token pemanggil bukan token peniruan tingkat identifikasi. Jika token saat ini bukan kontainer aplikasi tetapi merupakan token tingkat identitas, Anda harus mengembalikan AccessDenied.
[out, optional] TokenInformation
Penunjuk ke buffer fungsi mengisi dengan informasi yang diminta. Struktur yang dimasukkan ke dalam buffer ini tergantung pada jenis informasi yang ditentukan oleh parameter TokenInformationClass .
[in] TokenInformationLength
Menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter TokenInformation . Jika TokenInformationadalah NULL, parameter ini harus nol.
[out] ReturnLength
Penunjuk ke variabel yang menerima jumlah byte yang diperlukan untuk buffer yang diacu oleh parameter TokenInformation . Jika nilai ini lebih besar dari nilai yang ditentukan dalam parameter TokenInformationLength , fungsi gagal dan tidak menyimpan data dalam buffer.
Jika nilai parameter TokenInformationClass adalah TokenDefaultDacl dan token tidak memiliki DACL default, fungsi mengatur variabel yang diarahkan oleh ReturnLength ke sizeof(TOKEN_DEFAULT_DACL) dan mengatur anggota DefaultDacl dari struktur TOKEN_DEFAULT_DACL ke NULL.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Persyaratan
| Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | securitybaseapi.h (termasuk Windows.h) |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |