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

Manipula eventos de dispositivo de Reprodução Automática que contêm tipos de conteúdo que o aplicativo não está registrado para manipular. Esse método fornece um identificador para a janela de proprietário para que a interface do usuário possa ser exibida se o processo exigir privilégios elevados.

Sintaxe

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

Parâmetros

[in] pszDeviceID

Tipo: LPCWSTR

Um ponteiro para um buffer de cadeia de caracteres que contém a ID do dispositivo.

[in] pszAltDeviceID

Tipo: LPCWSTR

Um ponteiro para um buffer de cadeia de caracteres que contém a ID do dispositivo alternativo. A ID do dispositivo alternativo é mais legível do que a ID do dispositivo primário.

[in] pszEventType

Tipo: LPCWSTR

Um ponteiro para um buffer de cadeia de caracteres que contém o tipo de evento. Os tipos de evento incluem DeviceArrival, DeviceRemoval, MediaArrival e MediaRemoval.

[in] hwndOwner

Digite: HWND

Um identificador para a caixa de diálogo Reprodução Automática que foi exibida.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando um manipulador é invocado e requer elevação imediata de privilégio em um novo processo, ele requer um identificador de janela pai ativo para exibir sua interface do usuário de consentimento. IHWEventHandler::HandleEvent não pode dar um identificador, portanto, apenas uma barra de tarefas piscando é exibida. IHWEventHandler2::HandleEventWithHWND fornece o HWND e permite que a interface do usuário seja exibida.

Observe que, se o manipulador foi iniciado por padrão em vez de por ação direta do usuário, o HWND não está ativo e a caixa de diálogo não é mostrada em primeiro plano.

Os tipos de evento não são constantes de linguagem C/C++; são cadeias de caracteres de texto literais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl.h