Compartilhar via


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

Retorna a janela do Shell registrada para um índice especificado.

Sintaxe

HRESULT Item(
  [in, optional] VARIANT   index,
  [out, retval]  IDispatch **Folder
);

Parâmetros

[in, optional] index

Tipo: VARIANT

Uma VARIANT do tipo VT_UI4, VT_I2 ou VT_I4. Se o tipo for VT_UI4, o valor do índice será interpretado como um membro de ShellWindowTypeConstants; nesse caso, Item retorna a janela mais próxima da janela em primeiro plano e tem um tipo correspondente. Se o tipo for VT_I ou VT_I4, o índice será tratado como um índice na coleção de janelas do Shell.

[out, retval] Folder

Tipo: IDispatch**

Uma referência à interface IDispatch da janela ou NULL se a janela especificada não foi encontrada.

Retornar valor

Tipo: HRESULT

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

Código de retorno Descrição
S_OK
A janela especificada foi encontrada.
S_FALSE
A janela especificada não foi encontrada.

Requisitos

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

Confira também

IShellWindows

IShellWindows::_NewEnum

IShellWindows::get_Count