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

Voir aussi

Droits d’accès pour les objets Access-Token

GetCurrentProcessToken

GetCurrentThreadToken