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 值

注解

在 EvtRequestImpersonate 事件回调函数完成之前,WdfRequestImpersonate 方法不会返回。

有关详细信息,请参阅 处理 UMDF 驱动程序中的客户端模拟

要求

要求
最低受支持的客户端 Windows 8.1
目标平台 通用
最低 UMDF 版本 2.0
标头 wdfrequest.h (包括 Wdf.h)
Library WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

另请参阅

EvtRequestImpersonate

IWDFIoRequest::Impersonate