Método IWDFIoRequest::Impersonate (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.
El método Impersonate registra la interfaz para el método al que debe llamar el marco para la suplantación.
Sintaxis
HRESULT Impersonate(
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
[in] IImpersonateCallback *pCallback,
[in, optional] void *pvCallbackContext
);
Parámetros
[in] ImpersonationLevel
Valor de tipo SECURITY_IMPERSONATION_LEVEL que identifica el nivel de suplantación.
[in] pCallback
Puntero a la interfaz IImpersonateCallback cuyo método llama al marco para la suplantación.
[in, optional] pvCallbackContext
Puntero a un búfer que contiene información de contexto relacionada con la llamada de suplantación. El marco pasa esta información de contexto en una llamada al método IImpersonateCallback::OnImpersonate . Este parámetro es opcional. El controlador puede pasar NULL si el controlador no tiene que proporcionar un contexto.
Valor devuelto
Suplantar devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.
Comentarios
Para obtener información sobre cómo los controladores UMDF y UMDF controlan la suplantación, consulte Control de suplantación.
Requisitos
| Requisito | Value |
|---|---|
| Finalización del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| Plataforma de destino | Escritorio |
| Versión mínima de UMDF | 1.5 |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
| Archivo DLL | WUDFx.dll |