Condividi tramite

Funzione CheckTokenMembershipEx (securitybaseapi.h)

  • Articolo

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