Fonction CheckTokenCapability (securitybaseapi.h)

Article
08/25/2023

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