Partager via


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

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête securitybaseapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Kernel32.dll