Platform SDK: TAPI

IEnumAgent::Next

Gets the next specified number of elements in the enumeration sequence.

HRESULT Next(
  ULONG celt,
  ITAgent **ppElements,
  ULONG *pceltFetched
);

Parameters

celt
[in] Number of elements requested.
ppElements
[out] Pointer to ITAgent pointer.
pceltFetched
[out] Pointer to number of elements actually supplied. May be NULL if celt is one.

Return 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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

IEnumAgent, ITAgent