CheckTokenMembershipEx, fonction (securitybaseapi.h)

  • Article

La fonction CheckTokenMembershipEx détermine si le SID spécifié est activé dans le jeton spécifié.

Syntaxe

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

Paramètres

[in, optional] TokenHandle

Handle pour un jeton d’accès. S’il est présent, ce jeton est vérifié pour le SID. S’il n’est pas présent, le jeton effectif actuel est utilisé. Il doit s’agir d’un jeton d’emprunt d’identité.

[in] SidToCheck

Pointeur vers une structure SID. La fonction vérifie la présence de ce SID en présence du jeton.

[in] Flags

Indicateurs qui affectent le comportement de la fonction. Actuellement, le seul indicateur valide est CTMF_INCLUDE_APPCONTAINER qui permet aux conteneurs d’application de passer l’appel tant que les autres exigences du jeton sont remplies, telles que le groupe spécifié est présent et activé.

[out] IsMember

TRUE si le SID est activé dans le jeton ; sinon, FALSE.

Valeur retournée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Spécifications

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