Funzione CheckTokenCapability (securitybaseapi.h)

La funzione CheckTokenCapability controlla le funzionalità di un token specificato.

Sintassi

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

Parametri

[in, optional] TokenHandle

Handle a un token di accesso. L'handle deve avere TOKEN_QUERY accesso al token. Il token deve essere un token di rappresentazione.

Se TokenHandle è NULL, CheckTokenCapability usa il token di rappresentazione del thread chiamante. Se il thread non rappresenta, la funzione duplica il token primario del thread per creare un token di rappresentazione.

[in] CapabilitySidToCheck

Puntatore a una struttura SID di funzionalità. La funzione CheckTokenCapability controlla le funzionalità di questo token di accesso.

[out] HasCapability

Riceve i risultati del controllo. Se il token di accesso ha la funzionalità, restituisce TRUE, in caso contrario, restituisce FALSE.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare GetLastError

Requisiti

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