GetTokenInformation, fonction (securitybaseapi.h)

Article
08/25/2023

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