Método IEnumFsiItems::Next (imapi2fs.h)

Recupera um número especificado de itens na sequência de enumeração.

Sintaxe

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

Parâmetros

[in] celt

Número de itens a serem recuperados.

[out] rgelt

Matriz de interfaces IFsiItem . Você deve liberar cada interface no rgelt quando terminar.

[out] pceltFetched

Número de elementos retornados em rgelt. Você pode definir pceltFetched como NULL se o celt for um. Caso contrário, inicialize o valor de pceltFetched como 0 antes de chamar esse método.

Retornar valor

S_OK é retornado quando o número de elementos solicitados (celt) é retornado com êxito ou o número de itens retornados (pceltFetched) é menor que o número de elementos solicitados.

Outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno	Descrição
E_POINTER	O ponteiro não é válido. Valor: 0x80004003
E_OUTOFMEMORY	Falha ao alocar a memória necessária. Valor: 0x8007000E
E_INVALIDARG	Um ou mais argumentos não são válidos. Valor: 0x80070057

Comentários

Se houver menos do que o número solicitado de elementos restantes na sequência, ele recuperará os elementos restantes.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	imapi2fs.h

Confira também

IEnumFsiItems

IEnumFsiItems::RemoteNext