Compartir a través de

Método IShellWindows::FindWindowSW (exdisp.h)

  • Artículo

Busca una ventana en la colección de ventanas de Shell y devuelve el identificador de la ventana y la interfaz IDispatch .

Sintaxis

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

Parámetros

[in] pvarLoc

Tipo: VARIANT*

Variant de tipo VT_VARIANT | VT_BYREF. Establezca el valor de pvarLoc en un PIDL absoluto (PIDLIST_ABSOLUTE) que especifique la ventana que se va a buscar. (Vea los comentarios).

[in] pvarLocRoot

Tipo: VARIANT*

Debe ser NULL o de tipo VT_EMPTY.

[in] swClass

Tipo: int

Una o varias marcas ShellWindowTypeConstants que especifican los tipos de ventana que se van a incluir en la búsqueda.

[out] phwnd

Tipo: long*

Identificador de la ventana que coincide con los criterios de búsqueda especificados o NULL si no se encontró dicha ventana.

swfwOptions

Tipo: int

Una o varias marcas shellWindowFindWindowOptions que especifican opciones de búsqueda.

[out, retval] ppdispOut

Tipo: IDispatch**

Referencia a la interfaz IDispatch de la ventana o NULL si no se encontró dicha ventana.

Valor devuelto

Tipo: HRESULT

Uno de los valores siguientes o un código de resultado estándar.

Código devuelto Descripción
S_OK
 Se encontró una ventana que coincida con los criterios de búsqueda especificados.
S_FALSE
 No se encontró una ventana que coincida con los criterios de búsqueda especificados.
E_NOINTERFACE
 Se encontró una ventana, pero no se pudo obtener una referencia a la interfaz IDispatch de la ventana. Solo se produce si se establece la marca SWFO_NEEDDISPATCH .
E_PENDING
 Se encontró una ventana, pero la ventana está pendiente de abrirse. Solo se produce si se establece la marca SWFO_INCLUDEPENDING .

Comentarios

Si se establece la marca SWFO_COOKIEPASSED , pvarLoc se interpreta como una cookie en lugar de un PIDL.

Requisitos

   
Plataforma de destino Windows
Encabezado exdisp.h
Archivo DLL Shdocvw.dll (versión 5.00.2014.0216 o posterior)