DocumentBase.SendFaxOverInternet-Methode

Artikel
08/10/2011

Sendet das Dokument an einen Faxdienstanbieter, der das Dokument an einen oder mehrere angegebene Empfänger faxt.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntax

'Declaration
Public Sub SendFaxOverInternet ( _
    ByRef recipients As Object, _
    ByRef subject As Object, _
    ByRef showMessage As Object _
)

public void SendFaxOverInternet(
    ref Object recipients,
    ref Object subject,
    ref Object showMessage
)

Parameter

recipients
Typ: System.Object%
Die Faxnummern und E-Mail-Adressen der Personen, an die das Fax gesendet wird.Trennen Sie mehrere Empfänger durch ein Semikolon.

subject
Typ: System.Object%
Die Betreffzeile für das gefaxte Dokument.

showMessage
Typ: System.Object%
true, wenn die Faxnachricht vor dem Senden angezeigt werden soll.false, wenn das Fax gesendet werden soll, ohne es anzuzeigen.

Hinweise

Zur Verwendung dieser Methode muss auf dem Computer ein Faxdienst aktiviert sein. Ist kein Faxdienst aktiviert, löst die SendFaxOverInternet-Methode eine Ausnahme aus.

Das für das Angeben von Faxnummern im Recipients-Parameter verwendete Format ist entweder recipientsfaxnumber@usersfaxprovider oder recipientsname@recipientsfaxnumber. Über den folgenden Registrierungspfad können Sie auf die Faxanbieterinformationen des Benutzers zugreifen:

HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Common\Services\Fax

Verwenden Sie den FaxAddress-Schlüsselwert an diesem Registrierungsort, um für einen Benutzer das zu verwendende Format festzulegen. Wenn der Registrierungseintrag nicht vorhanden ist, ist kein Faxdienst verfügbar.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird die SendFaxOverInternet-Methode verwendet, um das Dokument unter Verwendung des Formats Faxnummer-Empfänger@Benutzerfax-Anbieter an eine Faxnummer zu senden. Im Code wird das Dokument vor dem Senden des Faxes angezeigt. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub DocumentSendFaxOverInternet()
    Me.SendFaxOverInternet("14255550101@consolidatedmessenger.com", _
        "For your review.", True)
End Sub

private void DocumentSendFaxOverInternet()
{
    object recipients = "14255550101@consolidatedmessenger.com";
    object subject = "For your review.";
    object showMessage = true;

    this.SendFaxOverInternet(ref recipients, ref subject, 
        ref showMessage);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace

Freigeben über