IVoIPCurrentCallEnumerator::Next

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

HRESULT Next( 
  unsigned long celt, 
  IVoIPCurrentCall** rgCCP, 
  unsigned long* pceltFetched 
);

celt
[in] Number of elements to fetch.
rgCCP
[out] Pointer to an array of IVoIPCurrentCall pointers. This buffer must be large enough to hold celt pointers. The call overwrites the current values in the first celt items of the array.

If the method succeeds, an object is created for each retrieved interface pointer. The caller must free these objects by using Release when they are no longer being used.
pceltFetched
[out] Pointer to the number of elements actually fetched by the enumerator, or NULL if no information is available. After the method returns, the array contains pceltFetched valid pointers. The caller releases this memory. If celt is greater than pceltFetched , the rest of array contains NULL.

The following table shows the possible return values.

Value	Description
S_FALSE	Some elements were fetched, but the total number is less than the specified number in celt parameter. The pceltFetched parameter contains the actual number of elements fetched.
S_OK	Specified number of elements were fetched.
VOIP_E_ENUMOUTOFDATE	The database was modified or the internal seek pointer was moved, which rendered the enumerator out of date. No items were fetched. The application must call IVoIPCurrentCallEnumerator::Reset to restore the out-of-date enumerator.

OS Versions: Windows CE .NET 4.2 and later.
Header: Voipmanager.h, Voipmanager.idl.
Link Library: Voipguid.lib.

其他资源