nf-exdisp-ishellwindows-findwindowsw.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	req.product	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:exdisp.IShellWindows.FindWindowSW	IShellWindows::FindWindowSW (exdisp.h)	Finds a window in the Shell windows collection and returns the window's handle and IDispatch interface.	FindWindowSW FindWindowSW method [Windows Shell] FindWindowSW method [Windows Shell] IShellWindows interface IShellWindows interface [Windows Shell] FindWindowSW method IShellWindows.FindWindowSW IShellWindows::FindWindowSW _win32_IShellWindows_FindWindowSW exdisp/IShellWindows::FindWindowSW shell.IShellWindows_FindWindowSW	shell\IShellWindows_FindWindowSW.htm	shell	10eed153-cb0b-4ce0-8cc5-2e7ebf683fda	12/05/2018	FindWindowSW, FindWindowSW method [Windows Shell], FindWindowSW method [Windows Shell],IShellWindows interface, IShellWindows interface [Windows Shell],FindWindowSW method, IShellWindows.FindWindowSW, IShellWindows::FindWindowSW, _win32_IShellWindows_FindWindowSW, exdisp/IShellWindows::FindWindowSW, shell.IShellWindows_FindWindowSW	exdisp.h		Windows							ExDisp.idl						Shdocvw.dll (version 5.00.2014.0216 or later)		Windows			Internet Explorer 5	19H1	IShellWindows::FindWindowSW exdisp/IShellWindows::FindWindowSW	c++	APIRef kbSyntax	COM	Shdocvw.dll	IShellWindows.FindWindowSW

IShellWindows::FindWindowSW

-description

Finds a window in the Shell windows collection and returns the window's handle and IDispatch interface.

-parameters

-param pvarLoc [in]

Type: VARIANT*

A VARIANT of type VT_VARIANT | VT_BYREF. Set the value of pvarLoc to an absolute PIDL (PIDLIST_ABSOLUTE) that specifies the window to find. (See remarks.)

-param pvarLocRoot [in]

Type: VARIANT*

Must be NULL or of type VT_EMPTY.

-param swClass [in]

Type: int

One or more ShellWindowTypeConstants flags that specify window types to include in the search.

-param phwnd [out]

Type: long*

A handle for the window matching the specified search criteria, or NULL if no such window was found.

-param swfwOptions

Type: int

One or more ShellWindowFindWindowOptions flags that specify search options.

-param ppdispOut [out, retval]

Type: IDispatch**

A reference to the window's IDispatch interface, or NULL if no such window was found.

-returns

Type: HRESULT

One of the following values, or a standard result code.

Return code	Description
S_OK	A window matching the specified search criteria was found.
S_FALSE	A window matching the specified search criteria was not found.
E_NOINTERFACE	A window was found, but a reference to the window's IDispatch interface could not be obtained. Only occurs if the SWFO_NEEDDISPATCH flag is set.
E_PENDING	A window was found, but the window is pending open. Only occurs if the SWFO_INCLUDEPENDING flag is set.

-remarks

If the SWFO_COOKIEPASSED flag is set, pvarLoc is interpreted as a cookie instead of a PIDL.