fungsi IUnknown_GetWindow (shlwapi.h)

  • Artikel

Mencoba mengambil handel jendela dari objek Model Objek Komponen (COM) dengan mengkueri berbagai antarmuka yang memiliki metode GetWindow .

Sintaks

LWSTDAPI IUnknown_GetWindow(
  [in]  IUnknown *punk,
  [out] HWND     *phwnd
);

Parameter

[in] punk

Jenis: IUnknown*

Penunjuk ke objek COM tempat fungsi ini akan mencoba mendapatkan handel jendela.

[out] phwnd

Jenis: HWND*

Penunjuk ke HWND yang, ketika fungsi ini berhasil dikembalikan, menerima handel jendela. Jika handel jendela tidak diperoleh, parameter ini diatur ke NULL.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika handel jendela berhasil dikembalikan, atau kode kesalahan COM sebaliknya. Jika tidak ada antarmuka yang cocok yang ditemukan, fungsi akan mengembalikan E_NOINTERFACE. Jika tidak, fungsi mengembalikan HRESULT yang dikembalikan oleh metode GetWindow antarmuka yang sesuai.

Keterangan

Fungsi ini mencoba mengambil handel jendela dengan memanggil IOleWindow::GetWindow, IInternetSecurityMgrSite::GetWindow, dan IShellView::GetWindow. Ada kemungkinan bahwa versi IUnknown_GetWindow di masa mendatang dapat mencoba antarmuka tambahan.

Catatan Kueri untuk IShellView secara teoritis tidak perlu karena IShellView berasal dari IOleWindow. Fungsi ini secara eksplisit mengkueri antarmuka ini karena beberapa objek mengimplementasikan QueryInterface secara salah dan gagal merespons kueri untuk antarmuka dasar.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server, Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
DLL Shlwapi.dll (versi 5.0 atau yang lebih baru)