Platform SDK: TAPI

IEnumBstr::Next

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

HRESULT Next(
  ULONG celt,
  BSTR *ppStrings,
  ULONG *pceltFetched
);

Parameters

celt: [in] Number of elements requested.
ppStrings: [out] Pointer to the list of BSTR pointers returned.
pceltFetched: [in,out,ptr] 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 ppStrings parameter is not a valid pointer.

Remarks

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

Requirements

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