SetThreadToken, fonction (processthreadsapi.h)
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