Método IEnumOleUndoUnits::Next (ocidl.h)

  • Artigo

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

Sintaxe

HRESULT Next(
  [in]  ULONG        cElt,
  [out] IOleUndoUnit **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 lançar.

[out] pcEltFetched

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

Valor retornado

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

Comentários

O chamador é responsável por chamar o método Release para cada elemento na matriz depois que esse método retorna com êxito. Se cUndoUnits for maior que um, o chamador também deverá passar um ponteiro não NULL para pcFetched para obter o número de ponteiros que precisa liberar.

E_NOTIMPL não é permitido como um valor retornado. Se um valor de erro for retornado, nenhuma entrada na matriz rgpcd será válida na saída e não exigirá nenhuma versão.

Requisitos

   
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 ocidl.h

Confira também

IEnumOleUndoUnits

IOleUndoUnit