Bagikan melalui


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

Lihat juga

Gambaran Umum Access Control

AdjustTokenGroups

AdjustTokenPrivileges

Fungsi Access Control Dasar

CheckTokenMembership

OpenProcessToken

OpenThreadToken

SECURITY_IMPERSONATION_LEVEL

SetTokenInformation

TOKEN_DEFAULT_DACL

TOKEN_GROUPS

TOKEN_GROUPS_AND_PRIVILEGES

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP

TOKEN_PRIVILEGES

TOKEN_SOURCE

TOKEN_STATISTICS

TOKEN_TYPE

TOKEN_USER