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

  • Artigo

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 celt for maior que 1, o chamador também deverá passar um ponteiro não NULL passado para pceltFetched para saber quantos ponteiros liberar.

[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

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidlbase.h (inclua ObjIdl.h)

Confira também

IEnumUnknown

IUnknown