RevertToSelf-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die RevertToSelf-Funktion beendet den Identitätswechsel einer Clientanwendung.

Syntax

BOOL RevertToSelf();

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

Ein Prozess sollte die RevertToSelf-Funktion aufrufen, nachdem der Identitätswechsel mit den Funktionen DdeImpersonateClient, ImpersonateDdeClientWindow, ImpersonateLoggedOnUser, ImpersonateNamedPipeClient, ImpersonateSelf, ImpersonateAnonymousToken oder SetThreadToken abgeschlossen wurde.

Ein RPC-Server, der die RpcImpersonateClient-Funktion zum Annehmen der Identität eines Clients verwendet hat, muss rpcRevertToSelf oder RpcRevertToSelfEx aufrufen, um den Identitätswechsel zu beenden.

Wenn RevertToSelf fehlschlägt, wird Ihre Anwendung weiterhin im Kontext des Clients ausgeführt, was nicht angemessen ist. Sie sollten den Prozess herunterfahren, wenn RevertToSelf fehlschlägt.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Überprüfen des Clientzugriffs mit ACLs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll