SendFaxOverInternet Method

Microsoft Word Visual Basic

SendFaxOverInternet Method

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

expression.SendFaxOverInternet(Recipients, Subject, ShowMessage)

expression    Required. An expression that returns a Document object.

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:

    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.

    ActiveDocument.SendFaxOverInternet _
    "[email protected]", _
    "For your review", True