Fungsi GetTokenInformation (securitybaseapi.h)

Artikel
03/15/2023

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