DocumentBase.SendFaxOverInternet - метод

Статья
08/11/2011

Отправляет документ поставщику службы факсов, который отправляет документ как факс одному или нескольким указанным получателям.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v4.0.Utilities (в Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Синтаксис

'Декларация
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
)

Параметры

recipients
Тип: System.Object%
Номера факса и адреса электронной почты пользователей, которым необходимо отправить факс.Несколько получателей отделяются друг от друга точкой с запятой.

subject
Тип: System.Object%
Строка темы для документа, отправляемого по факсу.

showMessage
Тип: System.Object%
Значение true для отображения факсимильного сообщения перед отправкой.Значение false, чтобы автоматически отправить сообщение факса без его отображения.

Заметки

Для использования этого метода необходимо, чтобы на компьютере пользователя была включена служба факсов. Если служба факсов недоступна, метод SendFaxOverInternet создает исключение.

Для указания номеров факса в параметре Recipients используется либо формат recipientsfaxnumber@usersfaxprovider, либо формат recipientsname@recipientsfaxnumber. Доступ к сведениям о поставщике факсов пользователя можно получить в следующем разделе реестра:

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

Следует использовать значение FaxAddress ключа в данном расположении реестра, чтобы определить формат, который необходимо использовать для пользователя. Если данная запись реестра не существует, служба факса недоступна.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В приведенном ниже примере кода метод SendFaxOverInternet используется для отправки документа на номер факса в формате recipientsfaxnumber@usersfaxprovider. Затем в коде перед отправкой факса выводится документ. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

DocumentBase Класс

Microsoft.Office.Tools.Word - пространство имен

Поделиться через