Функция WdfRequestImpersonate (wdfrequest.h)

Статья
02/07/2025

[Применимо только к 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

Поделиться через