GetCurrentThreadEffectiveToken-Funktion (processthreadsapi.h)

Ruft ein Pseudohandle ab, das Sie als Kurzform verwenden können, um auf das Token zu verweisen, das derzeit für den Thread gültig ist, wobei es sich um das Threadtoken handelt, falls vorhanden, und andernfalls das Prozesstoken.

Syntax

HANDLE GetCurrentThreadEffectiveToken();

Rückgabewert

Ein Pseudohandhandle, das Sie als Kurzform verwenden können, um auf das Token zu verweisen, das derzeit für den Thread gültig ist.

Hinweise

Ein Pseudohandle ist eine spezielle Konstante, die als effektives Token für den aktuellen Thread fungieren kann. Der aufrufende Thread kann ein Pseudohandle verwenden, um das effektive Token für diesen Thread anzugeben, wenn ein Tokenhandle erforderlich ist. Untergeordnete Prozesse erben keine Pseudohandles.

Ab Windows 8 verfügt dieses Pseudohandle nur über TOKEN_QUERY- und TOKEN_QUERY_SOURCE-Zugriffsrechte.

Das Pseudohandle kann nicht von der DuplicateHandle-Funktion oder der DuplicateToken-Funktion dupliziert werden.

Sie müssen das Pseudohandle nicht schließen, wenn Sie es nicht mehr benötigen. Wenn Sie die CloseHandle-Funktion mit einem Pseudohandle aufrufen, hat die Funktion keine Auswirkung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps	UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps	UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h

Weitere Informationen

Zugriffsrechte für Access-Token-Objekte

GetCurrentProcessToken

GetCurrentThreadToken