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 驱动程序中的客户端模拟。

要求

另请参阅

EvtRequestImpersonate

IWDFIoRequest：：Impersonate