PhoneSeekCallLog
This function initiates a search that ends at a given entry in a call log.
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:
PhoneSeekCallLog(h, CALLLOGSEEK_END, 0, &count);
Requirements
Pocket PC: Windows Mobile Version 5.0 and later
Smartphone: Windows Mobile Version 5.0 and later
OS Versions: Windows CE 5.01 and later.
Header: phone.h
Library: phone.lib
See Also
CALLLOGSEEK | PhoneCloseCallLog | PhoneGetCallLogEntry | PhoneOpenCallLog | Phone Functions
Send Feedback on this topic to the authors