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

Artículo
03/02/2024

El método Next obtiene el siguiente número especificado de elementos de la secuencia de enumeración.

Sintaxis

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

Parámetros

[in] celt

Número de elementos solicitados.

[out] ppElements

Puntero a punteros ITSubStream devueltos.

[out] pceltFetched

Puntero al número de elementos realmente proporcionados. Puede ser NULL si celt es uno.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	Método devuelto número celt de elementos.
S_FALSE	El número de elementos restantes era menor que celt.
E_POINTER	El parámetro ppElements no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.

Comentarios

TAPI llama al método AddRef en la interfaz ITSubStream devuelta por IEnumSubStream::Next. La aplicación debe llamar a Release en la interfaz ITSubStream para liberar recursos asociados.