Freigeben über


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

DdeImpersonateClient

Identität annehmenAnonymousToken

IdentitätswechselDdeClientWindow

IdentitätswechselLoggedOnUser

IdentitätswechselNamedPipeClient

IdentitätswechselSelf

RpcImpersonateClient

RpcRevertToSelf

RpcRevertToSelfEx

SetThreadToken