SetThreadToken-Funktion (processthreadsapi.h)

Die SetThreadToken-Funktion weist einem Thread ein Identitätswechseltoken zu. Die Funktion kann auch dazu führen, dass ein Thread die Verwendung eines Identitätswechseltokens beendet.

Syntax

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

Parameter

[in, optional] Thread

Ein Zeiger auf ein Handle auf den Thread, dem die Funktion das Identitätswechseltoken zuweist.

Wenn ThreadNULL ist, weist die Funktion das Identitätswechseltoken dem aufrufenden Thread zu.

[in, optional] Token

Ein Handle zum Identitätswechseltoken, das dem Thread zugewiesen werden soll. Dieses Handle muss mit TOKEN_IMPERSONATE Zugriffsrechten geöffnet worden sein. Weitere Informationen finden Sie unter Zugriffsrechte für Access-Token-Objekte.

Wenn TokenNULL ist, bewirkt die Funktion, dass der Thread kein Identitätswechseltoken mehr verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn Sie die SetThreadToken-Funktion zum Identitätswechsel verwenden, müssen Sie über die Berechtigungen zum Identitätswechsel verfügen und sicherstellen, dass die SetThreadToken-Funktion erfolgreich ist, bevor Sie die RevertToSelf-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (include Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

OpenThreadToken