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 |
---|---|
|
È stata trovata una finestra corrispondente ai criteri di ricerca specificati. |
|
Non è stata trovata una finestra corrispondente ai criteri di ricerca specificati. |
|
È 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. |
|
È 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) |