Método IEnumUnknown::Next (objidl.h)

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

Sintaxe

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

Parâmetros

[in] celt

O número de itens a serem recuperados. Se houver menos do que o número solicitado de itens restantes na sequência, esse método recuperará os elementos restantes.

[out] rgelt

Uma matriz de itens enumerados.

O enumerador é responsável por chamar AddRef e o chamador é responsável por chamar Release por meio de cada ponteiro enumerado. Se o celt for maior que 1, o chamador também deverá passar um ponteiro não NULL passado para pceltFetched para saber quantos ponteiros serão liberados.

[out] pceltFetched

O número de itens que foram recuperados. Esse parâmetro é sempre menor ou igual ao número de itens solicitados.

Retornar valor

Se o método recuperar o número de itens solicitados, o valor retornado será S_OK. Caso contrário, será S_FALSE.

Requisitos

Confira também

IEnumUnknown

IUnknown