Метод IImpersonateCallback::OnImpersonate (wudfddi.h)

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

Метод OnImpersonate обрабатывает олицетворение.

Синтаксис

void OnImpersonate(
  [in, optional] void *Context
);

Параметры

[in, optional] Context

Указатель на контекст, который ранее был указан в методе IWDFIoRequest::Impersonate . Этот параметр является необязательным и может иметь значение NULL , если контекст не требуется.

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

None

Remarks

Как правило, драйвер использует этот обратный вызов для прямого вызова функции Win32. Например, если драйвер должен открыть файл данных от имени приложения, отправляющего операцию ввода-вывода, драйвер требует олицетворения только для открытия дескриптора файла.

Чтобы предотвратить утечку олицетворения в функциях обратного вызова драйвера или между драйверами устройств, OnImpersonate не должен вызывать никакие методы платформы.

Драйвер регистрирует интерфейс IImpersonateCallback , когда драйвер вызывает метод IWDFIoRequest::Impersonate .

Дополнительные сведения о том, как драйверы UMDF и UMDF обрабатывают олицетворение, см. в разделе Обработка олицетворения.

Требования

Требование	Значение
Целевая платформа	Windows
Header	wudfddi.h (включая Wudfddi.h)

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

IImpersonateCallback

IWDFIoRequest::Impersonate