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

The ContactsNewContactfunction launches the Outlook Mobile Contacts application—directly into the Compose Form for a new Contact item.

Syntax

HRESULT ContactsNewContact();

Remarks

This function is one of two, that increases the Home Screen extensibility options available to OEMs and Mobile Operators. The other function is CalendarNewAppointment. Both functions significantly decrease the difficulty associated with creating custom Home screen plug-ins that enable programmatic navigation of the Outlook Mobile, Messaging, and Phone applications.

The ContactsNewContactfunction allows a plug-in or application to programmatically launch the Contacts application into its Compose Form to allow users to create a new Contact item—all without having to simulate keystrokes.

This behavior is the same as if the User started entering information for a new Contact item into the Contact Compose Form, navigated away to the Home Screen, and then returned to the Contacts application.

The Compose Form is displayed as if the User tapped New(Soft Key 1) from the Contacts List View.

Note that, beginning with Windows Mobile 6.5.3, soft keys are replaced by touchable tiles on Windows Mobile Professional phones.

If the Contacts application Compose Form or another dialog box is already being displayed when ContactsNewContactis called, then that window's contents must be saved, and the window dismissed—then ContactsNewContactis called.

Return Value

This function returns the following:

S_OK

The function completed successfully.

E_FAIL

The function call failed.

Requirements

Header appnav.h
Library aygshell.lib
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also