Forward Method (Message Object)

The Forward method returns a new Message object that can be used to forward the current message.

Syntax

Set objForwardMessage = objMessage.Forward( )

objForwardMessage

On successful return, contains the new Message object ready for forwarding.

objMessage

Required. This Message object.

Remarks

The Forward method copies the current message to the new message, including any Attachment objects associated with it. In keeping with forwarding conventions, Forward does not copy any Recipient objects to the new message. You must populate the Recipients collection before calling the Send method.

Forward does not save any changes or send any e-mail. You must call Update on the new Message object to save it in the messaging system, or Send to initiate transmission to the recipients.

The current implementation of the Forward method does not copy the Text property to the new message. If you call the Forward method on a MeetingItem object, it returns another MeetingItem object instead of a Message object. A recurring meeting is forwarded, but any instantiated individual recurrences are not.

If you call Forward on an AppointmentItem object, it returns CdoE_NO_SUPPORT if the appointment's MeetingStatus property is set to CdoNonMeeting. Otherwise it returns a MeetingItem object. This allows you to forward a meeting request that you have accepted.

Microsoft® Outlook™ deletes an accepted meeting request but leaves the resulting AppointmentItem intact with its MeetingStatus set to CdoMeeting. However, if you call GetAssociatedAppointment on the MeetingItem object returned by Forward, the AppointmentItem object is deleted. This is because CDO considers the new AppointmentItem object returned by GetAssociatedAppointment to be more recent. You can prevent this behavior by calling Update on the AppointmentItem object you wish to retain before you call GetAssociatedAppointment on the MeetingItem object.