MAPI_ResolveAddress()

Examples

The MAPI_ResolveAddress() function attempts to match a search string to an e-mail address in the address book.

This function requires Extended MAPI support.

Syntax

MAPI_ResolveAddress(search_name, show_dialog, name, email {, address_type})

Parameters

• search_name – A string containing the name or e-mail address to search for.

• show_dialog – A boolean. True specifies that the resolve dialog will be displayed if the search name cannot be resolved. False indicates that the dialog will not be displayed.

• name – A returned string containing the display name for the e-mail address that was found. If the search name could not be resolved, the empty string is returned.

• email – A returned string containing the e-mail address that was found. If the search name could not be resolved, the empty string is returned.

• address_type – An optional inout integer parameter that specifies the type of address to find. The value corresponds to one of the following constants:

Constant	Description
MAPI_ADDRESS_EXCHANGE	The Exchange e-mail address is returned.
MAPI_ADDRESS_SMTP	The SMTP e-mail address is returned.
MAPI_DEFAULT_ADDRESS	The default format of the e-mail address is returned. The value of the address_type parameter will be set to the constant indicating the address type returned.

Return value

A boolean. True indicates that a search result was found and returned, while false indicates that no result was found.