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

When the information for a specific entry in a call log is retrieved, the information is returned within a CALLLOGENTRYstructure, as the following example shows:

Syntax 

typedef struct {
  DWORD 
cbSize;
  FILETIME 
ftStartTime;
  FILETIME 
ftEndTime;
  IOM 
iom;
  BOOL 
fOutgoing:1;
  BOOL 
fConnected:1;
  BOOL 
fEnded:1;
  BOOL 
fRoam:1;
  CALLERIDTYPE 
cidt;
  PTSTR 
pszNumber;
  PTSTR 
pszName;
  PTSTR 
pszNameType;
  PTSTR 
pszNote;
  DWORD 
dwLogFlags;
  CEIOD 
iodContact;
	CEPROPID 
pidProp;
} CALLLOGENTRY, * PCALLLOGENTRY;

Members

cbSize

The size of the CALLLOGENTRYstructure. The value of this member must be set to sizeof CALLLOGENTRYbefore the PhoneGetCallLogEntryfunction is called.

ftStartTime

The start time of the logged call.

ftEndTime

The end time of the logged call.

iom

Indicates whether the call was incoming and was missed or answered, or whether the call was outgoing. This member contains one of the values in the IOMenumeration.

fOutgoing:1

Indicates the direction of the call.

fConnected:1

Indicates whether the call was connected, as opposed to the response being a busy signal or no answer.

fEnded:1

Indicates whether the call was ended, as opposed to being dropped.

fRoam:1

Indicates whether the call was made while the user was outside the home service area (roaming), as opposed to being made within the home service area.

cidt

The caller ID type. This member contains one of the values in the CALLERIDTYPEenumeration.

pszNumber

The pointer to the telephone number that is associated with the call.

pszName

The pointer to the name that is associated with the call.

pszNameType

Pointer to the name type that is associated with the call. For example, the letter wwould correspond with the work telephone number, and the letter hwould correspond with the home telephone number, and so on.

pszNote

Pointer to the file name of the Notes file that is associated with the call, if such a Notes file exists.

dwLogFlags

The call-log flags that indicate the type of call. This field is used to set the call type and will override if other parameters like fOutgoing, conflict with this value.

iodContact

The object ID of the contact entry for which the call is logged. This is always NULLin the CALLOGENTRYstructure returned in PhGetCallLogEntry.

pidProp

The contact property identifier for this contact.

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