Metodo IHWEventHandler2::HandleEventWithHWND (shobjidl.h)

Gestisce gli eventi del dispositivo AutoPlay che contengono tipi di contenuto che l'applicazione non è registrata per gestire. Questo metodo fornisce un handle alla finestra del proprietario in modo che l'interfaccia utente possa essere visualizzata se il processo richiede privilegi elevati.

Sintassi

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

Parametri

[in] pszDeviceID

Tipo: LPCWSTR

Puntatore a un buffer stringa contenente l'ID dispositivo.

[in] pszAltDeviceID

Tipo: LPCWSTR

Puntatore a un buffer stringa contenente l'ID dispositivo alternativo. L'ID dispositivo alternativo è più leggibile rispetto all'ID dispositivo primario.

[in] pszEventType

Tipo: LPCWSTR

Puntatore a un buffer stringa contenente il tipo di evento. I tipi di evento includono DeviceArrival, DeviceRemoval, MediaArrival e MediaRemoval.

[in] hwndOwner

Tipo: HWND

Handle della finestra di dialogo AutoPlay visualizzata.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando un gestore viene richiamato e richiede l'elevazione immediata dei privilegi in un nuovo processo, è necessario che un handle di finestra padre attivo visualizzi l'interfaccia utente di consenso. IHWEventHandler::HandleEvent non può assegnare un handle, quindi viene visualizzata solo una barra delle applicazioni blinking. IHWEventHandler2::HandleEventWithHWND fornisce HWND e abilita la visualizzazione dell'interfaccia utente.

Si noti che se il gestore è stato avviato per impostazione predefinita anziché da un'azione utente diretta, HWND non è attivo e la finestra di dialogo non viene visualizzata in primo piano.

I tipi di evento non sono costanti del linguaggio C/C++; sono stringhe di testo letterali.

Requisiti