Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

This function returns the information for the specified call log entry and then advances the seek pointer to the next entry in the call log.

Syntax 

HRESULT PhoneGetCallLogEntry(
  HANDLE 
h,
  PCALLLOGENTRY 
pentry
);

Parameters

h

[in] Handle of the call log.

pentry

Pointer to a CALLLOGENTRYstructure that gets the information in the call log. Before calling PhoneGetCallLogEntry, the value of cbSizewithin the CALLLOGENTRYstructure must be set to sizeof CALLLOGENTRY.

Return Values

Value Description

E_FAIL

The call log data is corrupt.

E_INVALIDARG

One of the following:

  • The value of cbSizeis incorrect.

  • handleis null

S_FALSE

There are no more entries in the call log.

S_OK

The process completed successfully.

Remarks

PhoneGetCallLogEntryretrieves the information for the current call log entry. Call log entries are returned in order of start time (the most recent call is returned first).

LocalFreemust be called for any strings that are returned by this function.

Requirements

Header phone.h
Library phone.lib
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also