Recipient Object (Outlook)

Represents a user or resource in Outlook, generally a mail or mobile message addressee.

Remarks

Use the Recipients(index) method, where index is the name or index number, to return a single Recipient object. The name can be a string that represents the display name, the alias, the full SMTP e-mail address, or the mobile phone number of the recipient. A good practice is to use the SMTP e-mail address for a mail message, and the mobile phone number for a mobile message.

Use the Add method to create a new Recipient object and add it to the Recipients object. The Type property of a new Recipient object is set to the default value for the associated AppointmentItem, JournalItem, MailItem, MeetingItem, or TaskItem object and must be reset to indicate another recipient type.

Example

The following Visual Basic for Applications (VBA) example creates a new MailItem object and adds Jon Grande as the recipient by using the default type ("To").

Set myItem = Application.CreateItem(olMailItem) 
 
Set myRecipient = myItem.Recipients.Add ("Jon Grande")

The following VBA example creates the same MailItem object as the preceding example, and then changes the type of the Recipient object from the default (To) to CC.

Set myItem = Application.CreateItem(olMailItem) 
 
Set myRecipient = myItem.Recipients.Add ("Jon Grande") 
 
myRecipient.Type = olCC

See Also

Concepts

Recipient Object Members

How to: Obtain the E-mail Address of a Recipient

Outlook Object Model Reference