CheckTokenMembershipEx-Funktion (securitybaseapi.h)

  • Artikel

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