IHWEventHandler2::HandleEventWithHWND-Methode (shobjidl.h)

  • Artikel

Verarbeitet Geräteereignisse mit automatischer Wiedergabe, die Inhaltstypen enthalten, für die die Anwendung nicht registriert ist. Diese Methode stellt ein Handle für das Besitzerfenster bereit, sodass die Benutzeroberfläche angezeigt werden kann, wenn der Prozess erhöhte Berechtigungen erfordert.

Syntax

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

Parameter

[in] pszDeviceID

Typ: LPCWSTR

Ein Zeiger auf einen Zeichenfolgenpuffer, der die Geräte-ID enthält.

[in] pszAltDeviceID

Typ: LPCWSTR

Ein Zeiger auf einen Zeichenfolgenpuffer, der die alternative Geräte-ID enthält. Die alternative Geräte-ID ist besser lesbar als die primäre Geräte-ID.

[in] pszEventType

Typ: LPCWSTR

Ein Zeiger auf einen Zeichenfolgenpuffer, der den Ereignistyp enthält. Zu den Ereignistypen gehören DeviceArrival, DeviceRemoval, MediaArrival und MediaRemoval.

[in] hwndOwner

Typ: HWND

Ein Handle für das Dialogfeld "Automatische Wiedergabe", das angezeigt wurde.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn ein Handler aufgerufen wird und eine sofortige Rechteerweiterung in einem neuen Prozess erfordert, ist ein aktives übergeordnetes Fensterhandle erforderlich, um seine Zustimmungs-UI anzuzeigen. IHWEventHandler::HandleEvent kann kein Handle geben, daher wird nur eine blinkende Taskleiste angezeigt. IHWEventHandler2::HandleEventWithHWND stellt den HWND bereit und ermöglicht die Anzeige der Benutzeroberfläche.

Beachten Sie, dass der HWND nicht im Vordergrund angezeigt wird, wenn der Handler standardmäßig anstelle einer direkten Benutzeraktion gestartet wurde.

Die Ereignistypen sind keine C/C++-Sprachkonstanten. dabei handelt es sich um Literaltextzeichenfolgen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl.h