ImpersonateNamedPipeClient 関数 (namedpipeapi.h)

[アーティクル]
03/08/2023

ImpersonateNamedPipeClient 関数は、名前付きパイプクライアントアプリケーションを偽装します。

構文

BOOL ImpersonateNamedPipeClient(
  [in] HANDLE hNamedPipe
);

パラメーター

[in] hNamedPipe

名前付きパイプへのハンドル。

戻り値

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

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

解説

ImpersonateNamedPipeClient 関数を使用すると、名前付きパイプのサーバー側でクライアント側を偽装できます。この関数が呼び出されると、名前付きパイプファイルシステムによって呼び出し元プロセスのスレッドが変更され、パイプから読み取られた最後のメッセージのセキュリティコンテキストの偽装が開始されます。この関数を呼び出すことができるのは、パイプのサーバー側だけです。

偽装が完了すると、サーバーは RevertToSelf 関数を呼び出すことができます。

大事なImpersonateNamedPipeClient 関数が失敗した場合、クライアントは偽装されず、後続のすべてのクライアント要求は、関数を呼び出したプロセスのセキュリティコンテキストで行われます。呼び出し元のプロセスが特権アカウントとして実行されている場合は、クライアントが実行を許可されないアクションを実行できます。セキュリティリスクを回避するには、呼び出し元のプロセスで常に戻り値をチェックする必要があります。戻り値が関数呼び出しに失敗したことを示す場合は、クライアント要求を実行する必要はありません。

ImpersonateNamedPipeClient を含むすべての偽装関数では、次のいずれかが当てはまる場合、要求された偽装が許可されます。

トークンの要求された偽装レベルは、SecurityIdentification や SecurityAnonymous など、SecurityImpersonation よりも小さくなります。
呼び出し元には SeImpersonatePrivilege 特権があります。
プロセス (または呼び出し元のログオンセッション内の別のプロセス) は、 LogonUser または LsaLogonUser 関数を介して明示的な資格情報を使用してトークンを作成しました。
認証された ID は呼び出し元と同じです。

SP1 以前の Windows XP: SeImpersonatePrivilege 特権はサポートされていません。

例

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

要件

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