RevertToSelf 関数 (securitybaseapi.h)

RevertToSelf 関数は、クライアント アプリケーションの偽装を終了します。

構文

BOOL RevertToSelf();

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

プロセスでは、DdeImpersonateClientImpersonateDdeClientWindowImpersonateLoggedOnUserImpersonateNamedPipeClient、ImpersonateSelfImpersonateAnonymousTokenまたは SetThreadToken 関数を使用して、偽装が開始された後に RevertToSelf 関数を呼び出す必要があります。

RpcImpersonateClient 関数を使用してクライアントを偽装した RPC サーバーは、偽装を終了するために RpcRevertToSelf または RpcRevertToSelfEx を呼び出す必要があります。

RevertToSelf が失敗した場合、アプリケーションはクライアントのコンテキストで実行され続けますが、これは適切ではありません。 RevertToSelf が失敗した場合は、プロセスをシャットダウンする必要があります。

この関数を使用する例については、「 ACL を使用したクライアント アクセスの検証」を参照してください。

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー securitybaseapi.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

こちらもご覧ください

クライアント/サーバー Access Control関数

クライアント/サーバー Access Controlの概要

DdeImpersonateClient

ImpersonateAnonymousToken

ImpersonateDdeClientWindow

ImpersonateLoggedOnUser

ImpersonateNamedPipeClient

ImpersonateSelf

RpcImpersonateClient

RpcRevertToSelf

RpcRevertToSelfEx

SetThreadToken