PhoneSeekCallLog

4/8/2010

This function initiates a search that ends at a given entry in a call log.

Syntax

HRESULT PhoneSeekCallLog(
    HANDLE h,
    CALLLOGSEEK seek,
    DWORD iRecord,
    LPDWORD piRecord 
); 

Parameters

• [in] h
  Handle of the call log to be searched.

• [in] seek
  Location within the call log where the search will begin. This parameter refers to the following seek parameter values to determine where the search will start.

  Value	Meaning
  CALLLOGSEEK_BEGINNING	The search will start at the beginning of the call log.
  CALLLOGSEEK_END	The search will start at the end of the call log.

• [in] iRecord
  The zero-based index value of an entry in the call log, starting at the beginning of the log if seek is set to CALLLOGSEEK_BEGINNING and at the end if seek is set to CALLLOGSEEK_END.

• [out] piRecord
  Returns the zero-based index value of the found record. The indexing is based on the beginning of the call log.

Return Values

Value	Description
E_FAIL	The function failed to return a pointer to the call log.
S_OK	The process completed successfully.

Remarks

After using PhoneOpenCallLog to open a specific call log, call PhoneSeekCallLog to jump to the call log entry to be read.

To retrieve the total number of records in that log (and leave the pointer at the last record), add one to the value of count after the following function call:

(h, CALLLOGSEEK_END, 0, &count
PhoneSeekCallLog);

Requirements

Header	phone.h
Library	phone.lib
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

CALLLOGSEEK
PhoneCloseCallLog
PhoneGetCallLogEntry
PhoneOpenCallLog
Phone Functions