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 |