Método IEnumShellItems::Next (shobjidl_core.h)

Artigo
03/02/2024

Obtém uma matriz de uma ou mais interfaces IShellItem da enumeração .

Sintaxe

HRESULT Next(
  [in]  ULONG      celt,
  [out] IShellItem **rgelt,
  [out] ULONG      *pceltFetched
);

Parâmetros

[in] celt

Tipo: ULONG

O número de elementos na matriz referenciada pelo parâmetro rgelt .

[out] rgelt

Tipo: IShellItem**

O endereço de uma matriz de ponteiros para interfaces IShellItem que recebem o item ou itens enumerados. O aplicativo de chamada é responsável por liberar as interfaces IShellItem chamando o método IUnknown::Release .

[out] pceltFetched

Tipo: ULONG*

Um ponteiro para um valor que recebe o número de interfaces IShellItem recuperadas com êxito. A contagem pode ser menor que o valor especificado no parâmetro celt . Esse parâmetro só poderá ser NULL na entrada se celt for um, pois nesse caso o método só poderá recuperar um item e retornar S_OK ou zero itens e retornar S_FALSE.

Retornar valor

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	se pelo menos a interface IShellItem foi recuperada.
S_FALSE	se não houver mais interfaces IShellItem na enumeração .
	Retorna um valor de erro se a função falhar por qualquer outro motivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

IEnumShellItems

Ishellitem

Share via