Compartilhar via

Método IEnumStream::Next (tapi3if.h)

  • Artigo

O método Next obtém o próximo número especificado de elementos na sequência de enumeração.

Sintaxe

HRESULT Next(
  [in]  ULONG    celt,
  [out] ITStream **ppElements,
  [out] ULONG    *pceltFetched
);

Parâmetros

[in] celt

Número de elementos solicitados.

[out] ppElements

Ponteiro para ponteiros ITStream retornados.

[out] pceltFetched

Ponteiro para o número de elementos realmente fornecidos. Pode ser NULL se o celt for um.

Retornar valor

Esse método pode retornar um desses valores.

Valor Significado
S_OK
 O método retornou o número de elementos celt .
S_FALSE
 O número de elementos restantes foi menor que o celt.
E_POINTER
 O parâmetro ppElements não é um ponteiro válido.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.

Comentários

O TAPI chama o método AddRef na interface ITStream retornada por IEnumStream::Next. O aplicativo deve chamar Release na interface ITStream para liberar recursos associados a ele.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)

Confira também

IEnumStream

ITStream

MSPI (Interface do Provedor de Serviços de Mídia)