IShellWindows::FindWindowSW-Methode (exdisp.h)

  • Artikel

Sucht ein Fenster in der Shellfenstersammlung und gibt das Handle und die IDispatch-Schnittstelle des Fensters zurück.

Syntax

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

Parameter

[in] pvarLoc

Typ: VARIANT*

Ein VARIANT vom Typ VT_VARIANT | VT_BYREF. Legen Sie den Wert von pvarLoc auf eine absolute PIDL (PIDLIST_ABSOLUTE) fest, die das zu suchende Fenster angibt. (Siehe Hinweise.)

[in] pvarLocRoot

Typ: VARIANT*

Muss NULL oder vom Typ VT_EMPTY sein.

[in] swClass

Typ: int

Mindestens ein ShellWindowTypeConstants-Flag , das Fenstertypen angibt, die in die Suche einbezogen werden sollen.

[out] phwnd

Typ: long*

Ein Handle für das Fenster, das den angegebenen Suchkriterien entspricht, oder NULL , wenn kein solches Fenster gefunden wurde.

swfwOptions

Typ: int

Mindestens ein ShellWindowFindWindowOptions-Flag, das Suchoptionen angibt.

[out, retval] ppdispOut

Typ: IDispatch**

Ein Verweis auf die IDispatch-Schnittstelle des Fensters oder NULL , wenn kein solches Fenster gefunden wurde.

Rückgabewert

Typ: HRESULT

Einer der folgenden Werte oder ein Standardergebniscode.

Rückgabecode BESCHREIBUNG
S_OK
 Es wurde ein Fenster gefunden, das den angegebenen Suchkriterien entspricht.
S_FALSE
 Ein Fenster, das den angegebenen Suchkriterien entspricht, wurde nicht gefunden.
E_NOINTERFACE
 Es wurde ein Fenster gefunden, aber ein Verweis auf die IDispatch-Schnittstelle des Fensters konnte nicht abgerufen werden. Tritt nur auf, wenn das SWFO_NEEDDISPATCH-Flag festgelegt ist.
E_PENDING
 Es wurde ein Fenster gefunden, aber das Fenster steht noch aus. Tritt nur auf, wenn das SWFO_INCLUDEPENDING-Flag festgelegt ist.

Hinweise

Wenn das SWFO_COOKIEPASSED-Flag festgelegt ist, wird pvarLoc als Cookie anstelle einer PIDL interpretiert.

Anforderungen

   
Zielplattform Windows
Kopfzeile exdisp.h
DLL Shdocvw.dll (Version 5.00.2014.0216 oder höher)