CheckTokenMembershipEx-Funktion (securitybaseapi.h)

Die CheckTokenMembershipEx-Funktion bestimmt, ob die angegebene SID im angegebenen Token aktiviert ist.

Syntax

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

Parameter

[in, optional] TokenHandle

Ein Handle für ein Zugriffstoken. Falls vorhanden, wird dieses Token für die SID überprüft. Wenn nicht vorhanden, wird das aktuell gültige Token verwendet. Dies muss ein Identitätswechseltoken sein.

[in] SidToCheck

Ein Zeiger auf eine SID-Struktur. Die Funktion überprüft, ob diese SID in Gegenwart des Tokens vorhanden ist.

[in] Flags

Flags, die das Verhalten der Funktion beeinflussen. Derzeit ist das einzige gültige Flag CTMF_INCLUDE_APPCONTAINER das es App-Containern ermöglicht, den Aufruf zu übergeben, solange die anderen Anforderungen des Tokens erfüllt sind, z. B. die angegebene Gruppe vorhanden und aktiviert ist.

[out] IsMember

TRUE , wenn die SID im Token aktiviert ist; andernfalls FALSE.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Kernel32.dll