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 |