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
目標平台 Universal
最低UMDF版本 2.0
標頭 wdfrequest.h (包含 Wdf.h)
程式庫 WUDFx02000.lib
Dll WUDFx02000.dll
IRQL PASSIVE_LEVEL

另請參閱

EvtRequestImpersonate

IWDFIoRequest::Impersonate