Platform SDK: TAPI

IEnumDialableAddrs::Next

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

HRESULT Next(
  ULONG celt,
  BSTR *ppElements,
  ULONG *pcFetched
);

Parameters

celt
[in] Number of elements requested.
ppElements
[out] Pointer to BSTR representation of address list.
pcFetched
[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.

Remarks

The application must use SysFreeString to free the memory allocated for the ppElements parameter.

Requirements

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

See Also

IEnumDialableAddrs