Metode IShellWindows::FindWindowSW (exdisp.h)

Artikel
08/23/2023

Menemukan jendela di koleksi jendela Shell dan mengembalikan handel jendela dan antarmuka IDispatch .

Sintaks

HRESULT FindWindowSW(
  [in]          VARIANT   *pvarLoc,
  [in]          VARIANT   *pvarLocRoot,
  [in]          int       swClass,
  [out]         long      *phwnd,
                int       swfwOptions,
  [out, retval] IDispatch **ppdispOut
);

Parameter

[in] pvarLoc

Jenis: VARIAN*

VARIAN jenis VT_VARIANT | VT_BYREF. Atur nilai pvarLoc ke PIDL absolut (PIDLIST_ABSOLUTE) yang menentukan jendela untuk ditemukan. (Lihat komentar.)

[in] pvarLocRoot

Jenis: VARIAN*

Harus NULL atau tipe VT_EMPTY.

[in] swClass

Jenis: int

Satu atau beberapa bendera ShellWindowTypeConstants yang menentukan jenis jendela yang akan disertakan dalam pencarian.

[out] phwnd

Jenis: panjang*

Handel untuk jendela yang cocok dengan kriteria pencarian yang ditentukan, atau NULL jika tidak ada jendela tersebut yang ditemukan.

swfwOptions

Jenis: int

Satu atau beberapa bendera ShellWindowFindWindowOptions yang menentukan opsi pencarian.

[out, retval] ppdispOut

Jenis: IDispatch**

Referensi ke antarmuka IDispatch jendela, atau NULL jika tidak ada jendela tersebut yang ditemukan.

Menampilkan nilai

Jenis: HRESULT

Salah satu nilai berikut, atau kode hasil standar.

Menampilkan kode	Deskripsi
S_OK	Jendela yang cocok dengan kriteria pencarian yang ditentukan ditemukan.
S_FALSE	Jendela yang cocok dengan kriteria pencarian yang ditentukan tidak ditemukan.
E_NOINTERFACE	Jendela ditemukan, tetapi referensi ke antarmuka IDispatch jendela tidak dapat diperoleh. Hanya terjadi jika bendera SWFO_NEEDDISPATCH diatur.
E_PENDING	Jendela ditemukan, tetapi jendela tertunda terbuka. Hanya terjadi jika bendera SWFO_INCLUDEPENDING diatur.

Keterangan

Jika bendera SWFO_COOKIEPASSED diatur, pvarLoc ditafsirkan sebagai cookie alih-alih PIDL.

Persyaratan


Target Platform	Windows
Header	exdisp.h
DLL	Shdocvw.dll (versi 5.00.2014.0216 atau yang lebih baru)

Bagikan melalui