Using the Address Book API

Address Book is an application that enables a user to save addresses, telephone numbers, and other contact information in an Auto PC running Microsoft® Windows® CE for the Auto PC. With Address Book, a user can dial a cellular phone number or look up an address. Address Book stores the information in Contacts, the Windows CE personal information manager (PIM) database.

The Address Book API is a simplified interface to a device’s Contacts database. It is a set of wrapper functions built around the Contacts database API. A wrapper function is a function that provides a simple interface to another function, for example by changing the order of some parameters or by interpreting the return code. The Address Book API enables youto display Address Book dialog boxes that allow a user to read and write records in the Contacts database. However, if you need to use contact information for more complex tasks, or if you do not intend to use dialog boxes, you can use the Contacts database API directly. For example, you must use the Contacts database API to search for or delete records from your application without prompting the user, or to add customized fields to the Contacts database. For more information about working with databases, see the Windows CE Programmer’s Guide in the documentation for the Microsoft® Windows® CE Platform SDK for Auto PCs.

The following table shows the Address Book API functions and their descriptions.

Function
Description
abOpen Starts Address Book and opens the Contacts database
abRead Reads a specified record from the Contacts database
abWrite Updates an existing record or creates a new record in the Contacts database
abDialog Displays one of nine predefined dialog boxes on an Auto PC screen, and returns the results of the user interaction
abClose Quits Address Book