Document.SendFaxOverInternet Method

  • Article
Word Developer Reference

Sends a document to a fax service provider, who faxes the document to one or more specfied recipients.

Syntax

expression.SendFaxOverInternet(Recipients, Subject, ShowMessage)

expression   Required. A variable that represents a Document object.

Parameters

Name Required/Optional Data Type Description
Recipients Optional Variant A String that represents the fax numbers and e-mail addresses of the people to whom to send the fax. Separate multiple recipients with a semicolon.
Subject Optional Variant A String that represents the subject line for the faxed document.
ShowMessage Optional Variant True displays the fax message before sending it. False sends the fax without displaying the fax message.

Remarks

Using the SendFaxOverInternet method requires that a fax service is enabled on a user's computer. If a fax service is not enabled, the SendFaxOverInternet method will cause a runtime error.

The format used for specifying fax numbers in the Recipients parameter is either recipientsfaxnumber@usersfaxprovider or recipientsname@recipientsfaxnumber. You can access the user's fax provider information using the following registry path:

Visual Basic for Applications 
  HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\Services\Fax

Use the FaxAddress key value at this registry location to determine the format to use for a user. If this registry entry does not exist, no fax service is available.

Example

The following example sends a fax to the fax service provider, who will fax the message to the recipient.

Visual Basic for Applications 
  ActiveDocument.SendFaxOverInternet _
    "14255550101@consolidatedmessenger.com", _
    "For your review", True

See Also