Метод IWDFIoRequest::Impersonate (wudfddi.h)
[ предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе Начало работы с UMDF.]
Метод олицетворение регистрирует интерфейс для метода, который платформа должна вызывать для олицетворения.
Синтаксис
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 и UMDF обрабатывают олицетворение, см. в обработке олицетворения.
Требования
| Требование | Ценность |
|---|---|
| завершение поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
| целевая платформа | Настольный |
| минимальная версия UMDF | 1.5 |
| заголовка | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |