SetThreadToken, fonction (processthreadsapi.h)

  • Article

La fonction SetThreadToken affecte un jeton d’emprunt d’identité à un thread. La fonction peut également provoquer l’arrêt d’un thread à l’aide d’un jeton d’emprunt d’identité.

Syntaxe

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

Paramètres

[in, optional] Thread

Pointeur vers un handle vers le thread auquel la fonction affecte le jeton d’emprunt d’identité.

Si Thread a la valeur NULL, la fonction affecte le jeton d’emprunt d’identité au thread appelant.

[in, optional] Token

Handle du jeton d’emprunt d’identité à affecter au thread. Ce handle doit avoir été ouvert avec TOKEN_IMPERSONATE droits d’accès. Pour plus d’informations, consultez Droits d’accès pour les objets Access-Token.

Si Token a la valeur NULL, la fonction entraîne l’arrêt du thread à l’aide d’un jeton d’emprunt d’identité.

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.

Remarques

Lorsque vous utilisez la fonction SetThreadToken pour emprunter l’identité, vous devez disposer des privilèges d’emprunt d’identité et vous assurer que la fonction SetThreadToken réussit avant d’appeler la fonction RevertToSelf .

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 processthreadsapi.h (inclure Windows.h)
Bibliothèque Advapi32.lib
DLL Advapi32.dll

Voir aussi

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

Fonctions Access Control de base

OpenThreadToken