Метод IWDFIoRequest::Impersonate (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. В UMDF 1 новые функции не добавляются, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с UMDF.]

Метод Impersonate регистрирует интерфейс метода, который платформа должна вызывать для олицетворения.

Синтаксис

HRESULT Impersonate(
  [in]           SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [in]           IImpersonateCallback         *pCallback,
  [in, optional] void                         *pvCallbackContext
);

Параметры

[in] ImpersonationLevel

SECURITY_IMPERSONATION_LEVEL типизированное значение, определяющее уровень олицетворения.

[in] pCallback

Указатель на интерфейс IImpersonateCallback , метод которого платформа вызывает для олицетворения.

[in, optional] pvCallbackContext

Указатель на буфер, содержащий контекстные сведения, связанные с вызовом олицетворения. Платформа передает эти сведения о контексте в вызове метода IImpersonateCallback::OnImpersonate . Этот параметр является необязательным. Драйвер может передать значение NULL , если драйверу не нужно предоставлять контекст.

Возвращаемое значение

При успешном выполнении операции олицетворения возвращается S_OK. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

См. также раздел

IImpersonateCallback

IImpersonateCallback::OnImpersonate

IWDFIoRequest

SECURITY_IMPERSONATION_LEVEL