Partager via


GetTokenInformation, fonction (securitybaseapi.h)

La fonction GetTokenInformation récupère un type spécifié d’informations sur un jeton d’accès. Le processus appelant doit disposer des droits d’accès appropriés pour obtenir les informations.

Pour déterminer si un utilisateur est membre d’un groupe spécifique, utilisez la fonction CheckTokenMembership . Pour déterminer l’appartenance au groupe pour les jetons de conteneur d’application, utilisez la fonction CheckTokenMembershipEx .

Syntaxe

BOOL GetTokenInformation(
  [in]            HANDLE                  TokenHandle,
  [in]            TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out, optional] LPVOID                  TokenInformation,
  [in]            DWORD                   TokenInformationLength,
  [out]           PDWORD                  ReturnLength
);

Paramètres

[in] TokenHandle

Handle pour un jeton d’accès à partir duquel les informations sont récupérées. Si TokenInformationClass spécifie TokenSource, le handle doit avoir un accès TOKEN_QUERY_SOURCE. Pour toutes les autres valeurs TokenInformationClass , le handle doit avoir un accès TOKEN_QUERY.

[in] TokenInformationClass

Spécifie une valeur du type énuméré TOKEN_INFORMATION_CLASS pour identifier le type d’informations que la fonction récupère. Tous les appelants qui case activée tokenIsAppContainer et qu’il retourne 0 doivent également vérifier que le jeton de l’appelant n’est pas un jeton d’emprunt d’identité de niveau d’identification. Si le jeton actuel n’est pas un conteneur d’application, mais un jeton de niveau identité, vous devez retourner AccessDenied.

[out, optional] TokenInformation

Pointeur vers une mémoire tampon que la fonction remplit avec les informations demandées. La structure placée dans cette mémoire tampon dépend du type d’informations spécifié par le paramètre TokenInformationClass .

[in] TokenInformationLength

Spécifie la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre TokenInformation . Si TokenInformation a la valeur NULL, ce paramètre doit être égal à zéro.

[out] ReturnLength

Pointeur vers une variable qui reçoit le nombre d’octets nécessaires pour la mémoire tampon vers laquelle pointe le paramètre TokenInformation . Si cette valeur est supérieure à la valeur spécifiée dans le paramètre TokenInformationLength , la fonction échoue et ne stocke aucune donnée dans la mémoire tampon.

Si la valeur du paramètre TokenInformationClass est TokenDefaultDacl et que le jeton n’a pas de DACL par défaut, la fonction définit la variable pointée par ReturnLength sur sizeof(TOKEN_DEFAULT_DACL) et définit le membre DefaultDacl de la structure TOKEN_DEFAULT_DACL sur NULL.

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étaillées sur l’erreur, appelez GetLastError.

Spécifications

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

Voir aussi

Vue d’ensemble du contrôle d’accès

AdjustTokenGroups

AdjustTokenPrivileges

Fonctions Access Control de base

CheckTokenMembership

OpenProcessToken

OpenThreadToken

SECURITY_IMPERSONATION_LEVEL

SetTokenInformation

TOKEN_DEFAULT_DACL

TOKEN_GROUPS

TOKEN_GROUPS_AND_PRIVILEGES

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP

TOKEN_PRIVILEGES

TOKEN_SOURCE

TOKEN_STATISTICS

TOKEN_TYPE

TOKEN_USER