IShellWindows：：FindWindowSW 方法 (exdisp.h)

在 Shell 視窗集合中尋找視窗，並傳回視窗的控制碼和 IDispatch 介面。

語法

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

參數

[in] pvarLoc

類型： VARIANT*

類型為 VT_VARIANT 的 VARIANT |VT_BYREF。 將 pvarLoc 的值設定為絕對 PIDL (PIDLIST_ABSOLUTE) ，指定要尋找的視窗。 (請參閱備註.)

[in] pvarLocRoot

類型： VARIANT*

必須是 Null 或類型為 VT_EMPTY。

[in] swClass

類型： int

一或多個 ShellWindowTypeConstants 旗標，指定要包含在搜尋中的視窗類型。

[out] phwnd

類型： long*

符合指定搜尋準則的視窗控制碼，如果找不到這類視窗，則為 Null 。

swfwOptions

類型： int

指定搜尋選項的一或多個 ShellWindowFindWindowOptions 旗標。

[out, retval] ppdispOut

類型： IDispatch**

視窗 IDispatch 介面的參考，如果找不到這類視窗，則為 Null 。

傳回值

類型： HRESULT

下列其中一個值，或標準結果碼。

傳回碼	描述
S_OK	找到符合指定搜尋準則的視窗。
S_FALSE	找不到符合指定搜尋準則的視窗。
E_NOINTERFACE	找到視窗，但無法取得視窗 IDispatch 介面的參考。 只有在 設定SWFO_NEEDDISPATCH 旗標時才會發生。
E_PENDING	找到視窗，但視窗暫止開啟。 只有在 設定SWFO_INCLUDEPENDING 旗標時才會發生。

備註

如果已設定 SWFO_COOKIEPASSED 旗標， pvarLoc 會解譯為 Cookie，而不是 PIDL。

需求

目標平台	Windows
標頭	exdisp.h
Dll	Shdocvw.dll (5.00.2014.0216 版或更新版本)