DocumentBase.SendFaxOverInternet(Object, Object, Object) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sends the document to a fax service provider, who faxes the document to one or more specified recipients.
public void SendFaxOverInternet (ref object recipients, ref object subject, ref object showMessage);member this.SendFaxOverInternet : obj * obj * obj -> unitPublic Sub SendFaxOverInternet (Optional ByRef recipients As Object, Optional ByRef subject As Object, Optional ByRef showMessage As Object)Parameters
- recipients
- Object
The fax numbers and e-mail addresses of the people to whom to send the fax. Separate multiple recipients with a semicolon.
- subject
- Object
The subject line for the faxed document.
- showMessage
- Object
true to display the fax message before sending it. false to send the fax without displaying the fax message.
Examples
The following code example uses the SendFaxOverInternet method to fax the document to a fax number using the format recipientsfaxnumber@usersfaxprovider. The code displays the document before sending the fax. To use this example, run it from the ThisDocument class in a document-level project.
private void DocumentSendFaxOverInternet()
{
object recipients = "[email protected]";
object subject = "For your review.";
object showMessage = true;
this.SendFaxOverInternet(ref recipients, ref subject,
ref showMessage);
}
Private Sub DocumentSendFaxOverInternet()
Me.SendFaxOverInternet("[email protected]", _
"For your review.", True)
End Sub
Remarks
Using this method requires that a fax service is enabled on a user's computer. If a fax service is not enabled, the SendFaxOverInternet method throws an exception.
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.
Optional Parameters
For information on optional parameters, see Optional Parameters in Office Solutions.