Resolve Method (Recipients Collection)

The Resolve method traverses the Recipients collection to resolve every recipient's 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 collection's 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 collection's Resolve method and should be retrieved again from the collection. Note that the individual recipient's 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 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.

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