Resolve Method (Recipient Object)
Resolve Method (Recipient Object)
The Resolve method resolves a recipients 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 objects 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 objects 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 objects Address property, the Resolve method does not attempt to compare the address against the address book.
The Resolve method validates the Recipient objects Type property and returns CdoE_INVALID_PARAMETER if it is not one of the defined recipient types.
You can call the Recipients collections Resolve method to resolve every object in the collection and also force an update to the collections 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 collections Resolved property is set to True when every recipient in the collection has its address resolved.
The following methods can invoke dialog boxes:
- Details method (AddressEntry object)
- Options and Send methods (Message object)
- Resolve method (Recipient object)
- Resolve method (Recipients_ collection)
- AddressBook and Logon methods (Session object)
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 running as a service, see "Windows NT Service Client Applications" in the MAPI Programmer's Reference under Guide, Introduction to MAPI Programming, Operating Environment Issues.