Metode IHWEventHandler2::HandleEventWithHWND (shobjidl.h)

Menangani peristiwa perangkat AutoPlay yang berisi jenis konten yang tidak didaftarkan aplikasi untuk ditangani. Metode ini menyediakan handel ke jendela pemilik sehingga UI dapat ditampilkan jika prosesnya memerlukan hak istimewa yang ditinggikan.

Sintaks

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

Parameter

[in] pszDeviceID

Jenis: LPCWSTR

Penunjuk ke buffer string yang berisi ID perangkat.

[in] pszAltDeviceID

Jenis: LPCWSTR

Penunjuk ke buffer string yang berisi ID perangkat alternatif. ID perangkat alternatif lebih dapat dibaca manusia daripada ID perangkat utama.

[in] pszEventType

Jenis: LPCWSTR

Penunjuk ke buffer string yang berisi jenis peristiwa. Jenis peristiwa termasuk DeviceArrival, DeviceRemoval, MediaArrival, dan MediaRemoval.

[in] hwndOwner

Jenis: HWND

Handel ke dialog AutoPlay yang ditampilkan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika handler dipanggil dan memerlukan elevasi hak istimewa segera dalam proses baru, handler memerlukan handel jendela induk aktif untuk menampilkan UI persetujuannya. IHWEventHandler::HandleEvent tidak dapat memberikan handel, sehingga hanya taskbar berkedip yang muncul. IHWEventHandler2::HandleEventWithHWND menyediakan HWND dan memungkinkan UI ditampilkan.

Perhatikan bahwa jika handler diluncurkan secara default alih-alih oleh tindakan pengguna langsung, HWND tidak aktif dan dialog tidak ditampilkan di latar depan.

Jenis peristiwa bukan konstanta bahasa C/C++; mereka adalah string teks harfiah.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h