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
h
Handle of the call log to be searched.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 seek==CALLLOGSEEK_BEGINNING The search will start at the beginning of the call log. seek==CALLLOGSEEK_END The search will start at the end of the call log. iRecord
The zero-based index value of an entry in the call log, starting at the beginning of the log if seek==CALLLOGSEEK_BEGINNING and at the end if seek==CALLLOGSEEK_END.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) call:
PhoneSeekCallLog(h, CALLLOGSEEK_END, 0, &count);
Requirements
Smartphone Platforms: Smartphone 2002 and later
OS Versions:
Header: phone.h
Library: phone.lib
See Also
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.