IVoIPCallerInfoDBEnum::Next

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

HRESULT Next( 
  unsigned long celt, 
  IVoIPCallerInfoRecord** rgVoIPCallerInfoRecord, 
  unsigned long* pceltFetched 
);

Parameters

  • celt
    [in] Number of elements to fetch.

  • rgVoIPCallerInfoRecord
    [out] Pointer to an array of IVoIPCallerInfoRecord pointers. This buffer must be large enough to hold celt interface pointers. The method 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 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 Values

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 IVoIPCallerInfoDBEnum::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

This method retrieves the items in the order specified when the enumerator was created. For example, an enumerator created by IVoIPCallerInfoDB::FriendlyNameEnumerator will retrieve the next celt records sorted alphabetically by friendly name.

Requirements

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

See Also

VoIP Application Interface Layer Architecture | VoIP Application Interface Layer Reference | IVoIPCallerInfoDBEnum::Reset | IVoIPCallerInfoDBEnum::Skip

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.