Bagikan melalui

Fungsi CheckTokenCapability (securitybaseapi.h)

  • Artikel

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