DocumentBase.SendFaxOverInternet 方法
將文件傳送至傳真服務提供者,此提供者會將文件傳真至一個或多個指定的收件者。
命名空間: 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 關鍵值 (Key Value),針對使用者判斷要採用的格式。 如果這個登錄項目不存在,就無法使用傳真服務。
選擇性參數
如需選擇性參數的詳細資訊,請參閱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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。