IP Contacts (PhInfo) Component (Windows Embedded CE 6.0)

1/6/2010

The IP Contacts (PhInfo) component is an executable that performs all contact operations.

This includes the following:

• Displaying and viewing Pocket Outlook Object Model (POOM) contacts
• Displaying and viewing speed dial entries
• Displaying and viewing call logs
• Displaying and viewing global address list (GAL) contacts.

VoIP Core Component Usage

The following diagram shows the VoIP Core Components that the IP Contacts application component uses.

Inter-Application Connections

None of the applications that make up the IP Phone Suite directly call each other. All inter-application communication is handled through calls to PhCommon or through the use of Registry settings. Even calls to the VAIL Database Store are handled via PhCommon database calls, including initialization and a pointer to the database for further API calls directly.

In the case of IP Contacts, the phinfo.exe uses all of the VoIP Core Components except for the Real-time Communications (RTC) Client API. Only IP Dialer uses RTC. However, most communication is handled through PhCommon, except for the Exchange Client and Pocket Outlook Object Model (POOM) if they are available.

IP Contacts uses the following PhCommon API sets:

• PhCommon Controls APIs
• PhCommon Settings APIs
• PhCommon Phone APIs
• PhCommon Command APIs
• PhCommon Database APIs
• PhCommon Authentication APIs

For example, IP Contacts would use PHMakePhoneCall to make a call, based on a call list selection. The call list, itself, was retrieved from the VAIL Database Store using PhCommon to make the initial connection to the database; or it was retrieved directly from Exchange when accessing a GAL record on the object.

If something were wrong when IP Contacts tried to make a connection to Exchange, IP Contacts would make a process call to launch IP Settings and take the user to the appropriate IP Settings screen to deal with the problem.

OS Design Information

For a table showing the operating design information for the IP Phone Suite, of which IP Contacts is just one part, please see IP Phone Suite OS Design Development.

Module

The following module implements IP Contacts. The module is an executable.

Item	Module
IP Contacts	phinfo

Source Code Location

The IP Phone Suite sample source code is located in %_WINCEROOT%\Public\VoIP\OAK\Phone\ and its subdirectories

For a complete source code location list, please see IP Phone Suite Source Code Directories.

The following table summarizes the contents of the directory of IP Contacts:

Directory or file name	Description
PHINFO	IP Contacts source code, including headers and any bitmaps or other resources.

Implementation Considerations

The following table shows the core Sysgen variable for IP Contacts. For a complete dependency list, showing all the Sysgens, please see the IP Phone Advanced Design Template and look at the advanced phone case.

Sysgen variable	Description
SYSGEN_VOIPPHONE_INFOAPP	IP Contacts application.

See Also

Reference

VAIL Database Store Reference
PhCommon Reference

Concepts

IP Phone Suite Architecture
IP Phone Suite

Other Resources

Real-time Communications (RTC) Client API
Exchange Client
Pocket Outlook Object Model (POOM)
State and Notifications Broker
Developing a VoIP Phone