Resolve Method (Recipients Collection)
Resolve Method (Recipients Collection)
The Resolve method traverses the Recipients collection to resolve every recipients address information into a full messaging address.
Syntax
objRecipColl.Resolve( [showDialog] )
objRecipColl
Required. The Recipients collection object.
showDialog
Optional. Boolean. If True (the default value), displays a modal dialog box to prompt the user to resolve ambiguous names.
Remarks
Calling the Recipients collections Resolve method is similar to calling the Resolve method for each Recipient object in the collection, except that it also forces an update to the Count property and to all Recipient objects in the collection. Any Recipient variable previously set to an object in the collection is invalidated by the collections Resolve method and should be retrieved again from the collection. Note that the individual recipients Resolve method does not invalidate the object.
The 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.
Example
' from the sample function Util_NewConversation
' create a valid new message object in the Outbox
With objNewMsg
.Subject = "used car wanted"
' ... set other properties here ...
Set objOneRecip = .Recipients.Add(Name:="Car Ads", _
Type:=CdoTo)
If objOneRecip Is Nothing Then
MsgBox "Unable to create the public folder recipient"
Exit Function
End If
.Recipients.Resolve ' resolve and update everything
End With