RevertToSelf-Funktion (securitybaseapi.h)
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 |
Weitere Informationen
Client-/Server-Access Control-Funktionen
Client/Server Access Control Übersicht
Identität annehmenAnonymousToken
IdentitätswechselDdeClientWindow