Метод 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, если контекст не требуется.

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

Никакой

Замечания

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

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

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

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

Требования

См. также

IImpersonateCallback

IWDFIoRequest::Impersonate