Resolve Method (Recipient Object)

The Resolve method resolves a recipient's address information into a full messaging address.

Syntax

objRecipient.Resolve( [showDialog] )

objRecipient
Required. The Recipient object.
showDialog
Optional. Boolean. If True (the default value), displays a modal dialog box to prompt the user to resolve ambiguous names.

Remarks

The Resolve method operates when the AddressEntry property is set to Nothing. Its operation depends on whether you have supplied the Recipient object's Name or Address property.

When you supply the Name property, Resolve looks it up in the address book. When a recipient is resolved, the Recipient object's Address property is set to the full address and its AddressEntry property is set to the child AddressEntry object that represents a copy of information in the address book.

When you specify a custom address by supplying only the Recipient object's Address property, the Resolve method does not attempt to compare the address against the address book.

The Resolve method validates the Recipient object's Type property and returns CdoE_INVALID_PARAMETER if it is not one of the defined recipient types.

You can call the Recipients collection's Resolve method to resolve every object in the collection and also force an update to the collection's Count property.

To avoid delivery errors, clients should always resolve recipients before submitting a message to the MAPI system. Resolving the recipient name means either finding a matching address in an address list or having the user select an address from a dialog box.

The Resolve method uses the address book or books specified in the profile, such as the global address list (GAL) and the personal address book (PAB).

The Recipients collection's Resolved property is set to true when every recipient in the collection has its address resolved.

The following methods can invoke dialog boxes:

However, if your application is running as a Microsoft® Windows NT® service, for example from Active Server Pages (ASP) script on a Microsoft® Internet Information Server (IIS), no user interface is allowed.

For more information on Windows NT services, see the Win32® Web page Using MAPI from a Windows NT Service at http://www.microsoft.com/win32dev/mapi/mapiserv.htm. For more information on running as a service, see "Windows NT Service Client Applications" in the MAPI Programmer's Reference.