WdfRequestImpersonate 関数 (wdfrequest.h)

[UMDF にのみ適用]

WdfRequestImpersonate メソッドは、フレームワークが偽装のために呼び出す必要があるドライバー指定のイベント コールバック関数を登録します。

構文

NTSTATUS WdfRequestImpersonate(
  [in]           WDFREQUEST                   Request,
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           PFN_WDF_REQUEST_IMPERSONATE  EvtRequestImpersonate,
  [in, optional] PVOID                        Context
);

パラメーター

[in] Request

完了している I/O 要求を表すフレームワーク要求オブジェクトへのハンドル。

[in] ImpersonationLevel

偽装のレベルを識別する SECURITY_IMPERSONATION_LEVEL型指定された値。

[in] EvtRequestImpersonate

ドライバーの EvtRequestImpersonate イベント コールバック関数へのポインター。

[in, optional] Context

偽装呼び出しに関連するコンテキスト情報を含むバッファーへのポインター。 フレームワークは、EvtRequestImpersonate イベント コールバック関数の呼び出しでこのコンテキスト情報を渡します。 このパラメーターは省略可能であり、NULL できます

戻り値

WdfRequestImpersonate メソッドでエラーが発生しなかった場合は、STATUS_SUCCESSが返されます。

このメソッドは、他NTSTATUS 値を返す場合があります。

備考

の WdfRequestImpersonate メソッドは、EvtRequestImpersonate イベント コールバック関数が完了するまで戻りません。

詳細については、「UMDF ドライバーでのクライアント偽装の処理」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1
ターゲット プラットフォーム の	万国
UMDF の最小バージョン を する	2.0
ヘッダー	wdfrequest.h (Wdf.h を含む)
ライブラリ	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

関連項目

EvtRequestImpersonate の

IWDFIoRequest::Impersonate