Método IHWEventHandler2::HandleEventWithHWND (shobjidl.h)

Controla los eventos de dispositivo de Reproducción automática que contienen tipos de contenido que la aplicación no está registrada para controlar. Este método proporciona un identificador a la ventana del propietario para que se pueda mostrar la interfaz de usuario si el proceso requiere privilegios elevados.

Sintaxis

HRESULT HandleEventWithHWND(
  [in] LPCWSTR pszDeviceID,
  [in] LPCWSTR pszAltDeviceID,
  [in] LPCWSTR pszEventType,
  [in] HWND    hwndOwner
);

Parámetros

[in] pszDeviceID

Tipo: LPCWSTR

Puntero a un búfer de cadena que contiene el identificador de dispositivo.

[in] pszAltDeviceID

Tipo: LPCWSTR

Puntero a un búfer de cadena que contiene el identificador de dispositivo alternativo. El identificador de dispositivo alternativo es más legible que el identificador de dispositivo principal.

[in] pszEventType

Tipo: LPCWSTR

Puntero a un búfer de cadena que contiene el tipo de evento. Los tipos de eventos incluyen DeviceArrival, DeviceRemoval, MediaArrival y MediaRemoval.

[in] hwndOwner

Tipo: HWND

Identificador del cuadro de diálogo Reproducción automática que se mostró.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cuando se invoca un controlador y se requiere una elevación de privilegios inmediata en un nuevo proceso, requiere un identificador de ventana principal activo para mostrar su interfaz de usuario de consentimiento. IHWEventHandler::HandleEvent no puede proporcionar un identificador, por lo que solo aparece una barra de tareas parpadeante. IHWEventHandler2::HandleEventWithHWND proporciona el HWND y permite que se muestre la interfaz de usuario.

Tenga en cuenta que si el controlador se inició de forma predeterminada en lugar de por acción directa del usuario, el HWND no está activo y el cuadro de diálogo no se muestra en primer plano.

Los tipos de eventos no son constantes del lenguaje C/C++; son cadenas de texto literales.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl.h