SeQueryInformationToken, fonction (ntifs.h)

Article
02/07/2025

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

Syntaxe

NTSTATUS SeQueryInformationToken(
  [in]  PACCESS_TOKEN           Token,
  [in]  TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out] PVOID                   *TokenInformation
);

Paramètres

[in] Token

Pointeur vers un jeton d’accès à partir duquel les informations doivent être récupérées. Si TokenInformationClass est défini sur TokenSource, le handle doit disposer d’un accès TOKEN_QUERY_SOURCE. Pour toutes les autres valeurs TokenInformationClass, le handle doit avoir TOKEN_QUERY accès.

[in] TokenInformationClass

Valeur du type énuméré TOKEN_INFORMATION_CLASS qui identifie le type d’informations à récupérer.

[out] TokenInformation

Si STATUS_SUCCESS est retourné, TokenInformation reçoit un pointeur vers un emplacement qui contient l’adresse d’une mémoire tampon contenant les informations demandées. Le format de cette mémoire tampon d’informations dépend de la valeur de TokenInformationClass, comme indiqué dans le tableau suivant. N’oubliez pas que la mémoire tampon est allouée par SeQueryInformationToken à partir du pool paginé. Cette mémoire tampon doit éventuellement être libérée par l’appelant à l’aide de ExFreePool.

Valeur	Description
TokenDefaultDacl	La mémoire tampon reçoit une structure TOKEN_DEFAULT_DACL qui contient la liste DACL par défaut pour les objets nouvellement créés.
TokenGroups	La mémoire tampon reçoit une structure TOKEN_GROUPS qui contient les comptes de groupe associés au jeton.
TokenImpersonationLevel	La mémoire tampon reçoit une valeur SECURITY_IMPERSONATION_LEVEL qui indique le niveau d’emprunt d’identité du jeton. Si le jeton d’accès n’est pas un jeton d’emprunt d’identité, l’appel à SeQueryInformationToken échoue.
tokenOwner	La mémoire tampon reçoit une structure TOKEN_OWNER qui contient l’identificateur de sécurité du propriétaire par défaut (SID) pour les objets nouvellement créés.
TokenPrimaryGroup	La mémoire tampon reçoit une structure TOKEN_PRIMARY_GROUP qui contient le SID de groupe principal par défaut pour les objets nouvellement créés.
TokenPrivileges	La mémoire tampon reçoit une structure TOKEN_PRIVILEGES qui contient les privilèges du jeton.
TokenSessionId	La mémoire tampon reçoit une valeur DWORD (et non un pointeur) qui indique l’identificateur de session Terminal Services associé au jeton. Si le jeton est associé à la session de console Terminal Server, l’identificateur de session est égal à zéro. Un identificateur de session différent de zéro indique une session cliente Terminal Services. Dans un environnement non-Terminal Services, l’identificateur de session est égal à zéro.
TokenSource	La mémoire tampon reçoit une structure TOKEN_SOURCE qui contient la source du jeton. TOKEN_QUERY_SOURCE l’accès est nécessaire pour récupérer ces informations.
TokenStatistics	La mémoire tampon reçoit une structure TOKEN_STATISTICS qui contient différentes statistiques de jeton.
TokenType	La mémoire tampon reçoit une valeur TOKEN_TYPE qui indique si le jeton est un jeton principal ou un jeton d’emprunt d’identité.
TokenUser	La mémoire tampon reçoit une structure TOKEN_USER qui contient le compte d’utilisateur du jeton.
TokenIntegrityLevel	La mémoire tampon reçoit une valeur d'DWORD (et non un pointeur vers celui-ci) qui spécifie le niveau d’intégrité du jeton.

Valeur de retour

Retourner le code	Description
STATUS_SUCCESS	L’appel à SeQueryInformationToken réussi.
STATUS_INVALID_INFO_CLASS	Une valeur non valide a été fournie pour TokenInformationClass.

Remarques

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL