Compartilhar via


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

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

Sintaxe

HRESULT Next(
  [in]      ULONG     celt,
  [out]     FORMATETC *rgelt,
  [in, 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 alocar qualquer memória e o chamador é responsável por liberá-la. 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.

[in, out] pceltFetched

O número de itens que foram recuperados. Esse parâmetro é sempre menor ou igual ao número de itens solicitados. Esse parâmetro poderá ser NULL se o celt for 1.

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

FORMATETC

Ienumformatetc