Функция 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

Дескриптор объекта запроса платформы, представляющий завершаемый запрос ввода-вывода.

[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