Fungsi CheckTokenMembershipEx (securitybaseapi.h)

Artikel
03/15/2023

Fungsi CheckTokenMembershipEx menentukan apakah SID yang ditentukan diaktifkan dalam token yang ditentukan.

Sintaks

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

Parameter

[in, optional] TokenHandle

Handel ke token akses. Jika ada, token ini diperiksa untuk SID. Jika tidak ada, maka token efektif saat ini digunakan. Ini harus menjadi token peniruan.

[in] SidToCheck

Penunjuk ke struktur SID. Fungsi ini memeriksa keberadaan SID ini di hadapan token.

[in] Flags

Bendera yang memengaruhi perilaku fungsi. Saat ini satu-satunya bendera yang valid adalah CTMF_INCLUDE_APPCONTAINER yang memungkinkan kontainer aplikasi untuk meneruskan panggilan selama persyaratan lain token terpenuhi, seperti grup yang ditentukan ada dan diaktifkan.

[out] IsMember

TRUE jika SID diaktifkan dalam token; jika tidak, FALSE.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan


Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Kernel32.dll

Bagikan melalui