Partager via


Fonction SetTokenInformation (securitybaseapi.h)

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

Voir aussi

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

AdjustTokenGroups

AdjustTokenPrivileges

Fonctions Access Control de base

GetTokenInformation

OpenProcessToken

OpenThreadToken

TOKEN_DEFAULT_DACL

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP