Fonction SetTokenInformation (securitybaseapi.h)

Article
03/04/2024

La fonction SetTokenInformation définit différents types d’informations pour un jeton d’accès spécifié. Les informations que cette fonction définit remplacent les informations existantes. Le processus appelant doit disposer des droits d’accès appropriés pour définir les informations.

Syntaxe

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Paramètres

[in] TokenHandle

Handle du jeton d’accès pour lequel les informations doivent être définies.

[in] TokenInformationClass

Valeur du TOKEN_INFORMATION_CLASS type énuméré qui identifie le type d’informations que la fonction définit. Les valeurs valides de TOKEN_INFORMATION_CLASS sont décrites dans le paramètre TokenInformation .

[in] TokenInformation

Pointeur vers une mémoire tampon qui contient les informations définies dans le jeton d’accès. La structure de cette mémoire tampon dépend du type d’informations spécifié par le paramètre TokenInformationClass .

[in] TokenInformationLength

Spécifie la longueur, en octets, de la mémoire tampon pointée par TokenInformation.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

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

Remarques

Pour définir des informations sur les privilèges, une application peut appeler la fonction AdjustTokenPrivileges . Pour définir les groupes d’un jeton, une application peut appeler la fonction AdjustTokenGroups .

Les informations de type de jeton peuvent être définies uniquement lorsqu’un jeton d’accès est créé.

Configuration requise

Condition requise	Valeur
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