Condividi tramite


Metodo IShellWindows::FindWindowSW (exdisp.h)

Trova una finestra nell'insieme windows shell e restituisce l'interfaccia IDispatch e l'handle della finestra.

Sintassi

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

Parametri

[in] pvarLoc

Tipo: VARIANT*

TIPO VARIANT VT_VARIANT | VT_BYREF. Impostare il valore di pvarLoc su un PIDL assoluto (PIDLIST_ABSOLUTE) che specifica la finestra da trovare. Vedere le osservazioni.

[in] pvarLocRoot

Tipo: VARIANT*

Deve essere NULL o di tipo VT_EMPTY.

[in] swClass

Tipo: int

Uno o più flag ShellWindowTypeConstants che specificano i tipi di finestra da includere nella ricerca.

[out] phwnd

Tipo: long*

Handle per la finestra corrispondente ai criteri di ricerca specificati o NULL se non è stata trovata alcuna finestra di questo tipo.

swfwOptions

Tipo: int

Uno o più flag ShellWindowFindWindowOptions che specificano le opzioni di ricerca.

[out, retval] ppdispOut

Tipo: IDispatch**

Riferimento all'interfaccia IDispatch della finestra o NULL se non è stata trovata alcuna finestra di questo tipo.

Valore restituito

Tipo: HRESULT

Uno dei valori seguenti o un codice risultato standard.

Codice restituito Descrizione
S_OK
È stata trovata una finestra corrispondente ai criteri di ricerca specificati.
S_FALSE
Non è stata trovata una finestra corrispondente ai criteri di ricerca specificati.
E_NOINTERFACE
È stata trovata una finestra, ma non è stato possibile ottenere un riferimento all'interfaccia IDispatch della finestra. Si verifica solo se il flag di SWFO_NEEDDISPATCH è impostato.
E_PENDING
È stata trovata una finestra, ma la finestra è in sospeso. Si verifica solo se il flag di SWFO_INCLUDEPENDING è impostato.

Commenti

Se il flag di SWFO_COOKIEPASSED è impostato, pvarLoc viene interpretato come cookie anziché come PIDL.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione exdisp.h
DLL Shdocvw.dll (versione 5.00.2014.0216 o successiva)