IEnumStream::Next method (tapi3if.h)

Article
02/22/2024

The Next method gets the next specified number of elements in the enumeration sequence.

Syntax

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

Parameters

[in] celt

Number of elements requested.

[out] ppElements

Pointer to ITStream pointers returned.

[out] pceltFetched

Pointer to number of elements actually supplied. May be NULL if celt is one.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method returned celt number of elements.
S_FALSE	Number of elements remaining was less than celt.
E_POINTER	The ppElements parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.

Remarks

TAPI calls the AddRef method on the ITStream interface returned by IEnumStream::Next. The application must call Release on the ITStream interface to free resources associated with it.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)