Fungsi CheckTokenCapability (securitybaseapi.h)

Fungsi CheckTokenCapability memeriksa kemampuan token tertentu.

Sintaks

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

Parameter

[in, optional] TokenHandle

Handel ke token akses. Handel harus memiliki akses TOKEN_QUERY ke token. Token harus berupa token peniruan.

Jika TokenHandleADALAH NULL, CheckTokenCapability menggunakan token peniruan utas panggilan. Jika utas tidak meniru, fungsi akan menduplikasi token utama utas untuk membuat token peniruan.

[in] CapabilitySidToCheck

Penunjuk ke struktur SID kemampuan. Fungsi CheckTokenCapability memeriksa kemampuan token akses ini.

[out] HasCapability

Menerima hasil pemeriksaan. Jika token akses memiliki kemampuan, token tersebut mengembalikan TRUE, jika tidak, token tersebut mengembalikan FALSE.

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 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Kernel32.dll