Funzione CheckTokenMembershipEx (securitybaseapi.h)

La funzione CheckTokenMembershipEx determina se il SID specificato è abilitato nel token specificato.

Sintassi

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

Parametri

[in, optional] TokenHandle

Handle per un token di accesso. Se presente, questo token viene controllato per il SID. Se non è presente, viene usato il token effettivo corrente. Deve trattarsi di un token di rappresentazione.

[in] SidToCheck

Puntatore a una struttura SID. La funzione verifica la presenza di questo SID in presenza del token.

[in] Flags

Flag che influiscono sul comportamento della funzione. Attualmente l'unico flag valido è CTMF_INCLUDE_APPCONTAINER che consente ai contenitori dell'app di passare la chiamata finché vengono soddisfatti gli altri requisiti del token, ad esempio il gruppo specificato è presente e abilitato.

[out] IsMember

TRUE se il SID è abilitato nel token; in caso contrario, FALSE.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Client minimo supportato	Windows 8 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Kernel32.dll