Forward Method

Forward a message.

Syntax

office365.forward(id, messageHTML, toRecipients, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method can be used to quickly forward a message specified by id to the recipients specified by toRecipients. The toRecipients parameter accepts a comma separated list of emails to forward the message to. The messageHTML parameter is the message body to include with the forward. If messageHTML is an empty string, then the following properties are used:

Property	Default if not set
MessageBcc	Blank
MessageBodyContent	Blank
MessageBodyContentType	HTML
MessageCc	Blank
MessageDeliveryReceipt	False
MessageFrom	Currently authenticated mailbox
MessageImportance	Blank
MessageReadReceipt	False
MessageSubject	FW:" + original subject

Example (Simple):

        office365.Forward(messageId, "This is an email I am forwarding.", "someguy@gmail.com, notreal@nsoftware.com");

Example (Advanced):

        office365.MessageSubject = "Subject for the reply";
        office365.MessageImportance = "Low";
        office365.MessageCc = "Example@email.com";
        office365.MessageBcc = "Example@email.com";
        office365.MessageBodyContent = "Reply Message body";
        office365.Forward(messageId, "", "example@email.com, exampletwo@email.com");

This method forwards a message specified by id. toRecipients accepts a comma separated list of emails to forward the message to.

Example (Forwarding a Message to Two Addresses)

office365.Forward(messageId, "This is an email I am forwarding.", "someguy@gmail.com, notreal@nsoftware.com");