Compartilhar via


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

Localiza uma janela na coleção Janelas do Shell e retorna o identificador da janela e a interface IDispatch .

Sintaxe

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*

Uma VARIANT do tipo VT_VARIANT | VT_BYREF. Defina o valor de pvarLoc como um PIDL absoluto (PIDLIST_ABSOLUTE) que especifica a janela a ser encontrada. (Consulte comentários.)

[in] pvarLocRoot

Tipo: VARIANT*

Deve ser NULL ou do tipo VT_EMPTY.

[in] swClass

Tipo: int

Um ou mais sinalizadores ShellWindowTypeConstants que especificam tipos de janela a serem incluídos na pesquisa.

[out] phwnd

Tipo: long*

Um identificador para a janela que corresponde aos critérios de pesquisa especificados ou NULL se nenhuma janela desse tipo foi encontrada.

swfwOptions

Tipo: int

Um ou mais sinalizadores ShellWindowFindWindowOptions que especificam opções de pesquisa.

[out, retval] ppdispOut

Tipo: IDispatch**

Uma referência à interface IDispatch da janela ou NULL se nenhuma janela desse tipo foi encontrada.

Valor retornado

Tipo: HRESULT

Um dos valores a seguir ou um código de resultado padrão.

Código de retorno Descrição
S_OK
Foi encontrada uma janela que corresponde aos critérios de pesquisa especificados.
S_FALSE
Uma janela que corresponde aos critérios de pesquisa especificados não foi encontrada.
E_NOINTERFACE
Uma janela foi encontrada, mas não foi possível obter uma referência à interface IDispatch da janela. Só ocorrerá se o sinalizador SWFO_NEEDDISPATCH estiver definido.
E_PENDING
Uma janela foi encontrada, mas a janela está pendente aberta. Só ocorrerá se o sinalizador SWFO_INCLUDEPENDING estiver definido.

Comentários

Se o sinalizador SWFO_COOKIEPASSED estiver definido, pvarLoc será interpretado como um cookie em vez de um PIDL.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho exdisp.h
DLL Shdocvw.dll (versão 5.00.2014.0216 ou posterior)