Fonction CheckTokenCapability (securitybaseapi.h)

La fonction CheckTokenCapability vérifie les fonctionnalités d’un jeton donné.

Syntaxe

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

Paramètres

[in, optional] TokenHandle

Handle à un jeton d’accès. Le handle doit avoir TOKEN_QUERY accès au jeton. Le jeton doit être un jeton d’emprunt d’identité.

Si TokenHandle a la valeur NULL, CheckTokenCapability utilise le jeton d’emprunt d’identité du thread appelant. Si le thread n’emprunte pas l’identité, la fonction duplique le jeton principal du thread pour créer un jeton d’emprunt d’identité.

[in] CapabilitySidToCheck

Pointeur vers une structure SID de capacité. La fonction CheckTokenCapability vérifie les fonctionnalités de ce jeton d’accès.

[out] HasCapability

Reçoit les résultats du case activée. Si le jeton d’accès a la fonctionnalité, il retourne TRUE, sinon, il retourne FALSE.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError

Spécifications