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

Phone API provides the functionality to access a call log and creates a custom report from the information in that log. Call logs list the information related to all of the incoming and outgoing calls for a device, allowing the user to track and return missed calls, manage billable time spent on the phone, and perform other tasks that make the device more powerful than a standard cell phone.

The Call Log application supports the context menu extensibility mechanism. The context name for this application is Phoneand the class name is Log. The IUnknownpointer that is passed from the application to the context menu handler supports the IPropertyBaginterface; the supported properties are listed in the following table.

Property name Property type Property value

PropSet

BSTR

The call log identifier.

Number

BSTR

The telephone number of the incoming call.

NumberType

BSTR

The type of telephone number of the incoming call (for example, "w" for "work").

Name

BSTR

The name of the person who placed the incoming call.

Year

I2

The year when the incoming call began.

Month

I2

The month when the incoming call began.

Day

I2

The day when the incoming call began.

Hour

I2

The hour when the incoming call began.

Minute

I2

The minute when the incoming call began.

Second

I2

The second when the incoming call began.

DayOfWeek

I2

The day of the week when the incoming call began.

Duration

UI4

The number of seconds that the call lasted.

CallerIDType

UI4

The caller ID type (available, blocked, or unavailable).

Connected

BOOL

Indicates whether the call connected (as opposed to a busy signal or no answer).

Ended

BOOL

Indicates whether the call ended (as opposed to being dropped).

Outgoing

BOOL

Indicates whether the call was outgoing (missed calls are incoming).

Roaming

BOOL

Indicates whether the call was made while the caller was roaming (out of standard service range).

IOM

UI4

Indicates whether the call was missed (incoming), answered (incoming), or outgoing.

See Also