GetCurrentThreadEffectiveToken, fonction (processthreadsapi.h)
Récupère un pseudo-handle que vous pouvez utiliser comme méthode abrégée pour faire référence au jeton actuellement en vigueur pour le thread, qui est le jeton de thread s’il en existe un et le jeton de processus dans le cas contraire.
Syntaxe
HANDLE GetCurrentThreadEffectiveToken();
Valeur de retour
Pseudo-handle que vous pouvez utiliser comme un raccourci pour faire référence au jeton actuellement en vigueur pour le thread.
Remarques
Un pseudo-handle est une constante spéciale qui peut fonctionner comme jeton effectif pour le thread actuel. Le thread appelant peut utiliser un pseudo-handle pour spécifier le jeton effectif pour ce thread chaque fois qu’un handle de jeton est requis. Les processus enfants n’héritent pas des pseudo-handles.
À compter de Windows 8, ce pseudo-handle n’a que des droits d’accès TOKEN_QUERY et TOKEN_QUERY_SOURCE.
Le pseudo-handle ne peut pas être dupliqué par la fonction DuplicateHandle ou la fonction DuplicateToken .
Vous n’avez pas besoin de fermer le pseudo-handle quand vous n’en avez plus besoin. Si vous appelez la fonction CloseHandle avec un pseudo-handle, la fonction n’a aucun effet.
Configuration requise
| Condition requise | Valeur | |
|---|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows | |
| En-tête | processthreadsapi.h |