Share via


Forward Method

Topic Last Modified: 2006-06-13

The Forward method creates and returns another message that can be used to forward this message.

Applies To

IMessage Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

Function Forward() As CDO.Message
HRESULT Forward
(
        IMessage** pVal
);

Parameters

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The Forward method returns the IMessage interface on the new message.

If the configuration field usemessageresponsetext Field is set to TRUE (VARIANT_TRUE), then the original message is formatted using the following:

-----Original Message-----
From:"Person" <person@example.com>
Sent:Tue, 23 Mar 1998 12:41:37 -0800
To:"Person A" <personA@example.com>
Subject:Hello There

The message response text is localized into the language specified by the languagecode Field.

The Forward method retains all the attachments from this message but does not set any recipients on the new message.