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