Share via

PhoneGetCallLogEntry

  • Article

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 CALLLOGENTRY structure that gets the information in the call log. Before calling PhoneGetCallLogEntry, the value of cbSize within the CALLLOGENTRY structure 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 cbSize is incorrect.
  • handle is null

S_FALSE

There are no more entries in the call log.

S_OK

The process completed successfully.

Remarks

PhoneGetCallLogEntry retrieves 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).

LocalFree must 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

Reference

CALLLOGENTRY
PhoneCloseCallLog
PhoneOpenCallLog
PhoneSeekCallLog
Phone Functions