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

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
);

Parameters

[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 do que o valor especificado no parâmetro de celt . Esse parâmetro só poderá ser NULL na entrada se o celt for um, pois nesse caso o método só pode recuperar um item e retornar S_OK ou zero itens e retornar S_FALSE.

Valor de devolução

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
se pelo menos uma 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.

Requirements

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

Consulte também

IEnumShellItems

IShellItem