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