Phone API Properties
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 Phone and the class name is Log. The IUnknown pointer that is passed from the application to the context menu handler supports the IPropertyBag interface; 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. |