Share via

IVoIPCallLogDBEnum::Next (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

Syntax

HRESULT Next( 
  unsigned long celt, 
  IVoIPCallRecord** rgVoIPCallRecord, 
  unsigned long* pceltFetched 
);

Parameters

  • celt
    [in] Number of elements to fetch.
  • rgVoIPCallRecord
    [out] Pointer to an array of IVoIPCallRecord 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 IUnknown::Release when they are no longer being used.
  • pceltFetched
    [out, retval] Pointer to the number of records actually fetched from the database, or NULL if no information is available. After the method returns, the array contains pceltFetched valid pointers. The caller is responsible for releasing this memory. If celt is greater than pceltFetched, the rest of array contains NULL.

Return Value

The following table shows the possible return values.

Value Description

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 IVoIPCallLogDBEnum::Reset to restore the out-of-date enumerator.

S_OK

Specified number of records was fetched.

S_FALSE

Some records were fetched, but the total number is less than the specified number in celt parameter. The pceltFetched parameter contains the actual number of records fetched.

Remarks

Note

This documentation applies to functionality implemented in sample code for the VAIL Database Store. For more information, see VAIL Database Store Reference.

The enumerator only retrieves call log records of the type associated with the enumerator when it is created. For example, an enumerator created by IVoIPCallLogDB::IncomingEnumerator enumerates incoming calls.

Requirements

Header Voipstore.h, voipstore.idl
Windows Embedded CE Windows CE .NET 4.2 and later

See Also

Reference

IVoIPCallLogDBEnum
VAIL Database Store Reference
IVoIPCallLogDB::IncomingEnumerator
IVoIPCallLogDBEnum::Reset
IVoIPCallLogDBEnum::Skip
IVoIPCallRecord