IEnumQueue::Next method (tapi3cc.h)

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

Syntax

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

Parameters

[in] celt

Number of elements requested.

[out] ppElements

Pointer to ITQueue list of interface 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 ITQueue interface returned by IEnumQueue::Next. The application must call Release on the ITQueue interface to free resources associated with it.

Requirements

   
Target Platform Windows
Header tapi3cc.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

ITQueue