共用方式為


IFaxServer 介面 (faxcom.h)

傳真用戶端應用程式會使用 IFaxServer 雙重介面來管理傳真服務的連線。 介面會擷取並設定 FaxServer 物件的相關資訊;例如,重新傳輸、商標、封存和封面的設定;折扣率週期;和傳真伺服器佇列的狀態。 IFaxServer介面包含下列方法:

  • 起始和終止與傳真伺服器連線的方法。
  • 用來擷取及設定 FaxServer 物件的個別屬性值的屬性方法。
  • 建立 FaxJobsFaxPortsFaxDoc 物件的方法。
注意 傳真用戶端應用程式必須呼叫 IFaxServer::Connect 方法來起始與使用中傳真伺服器的連線,才能存取以 IFax開頭的大部分介面。 (存取 IFaxTiff 介面時不需要傳真伺服器連線。)
 

繼承

IFaxServer介面繼承自IDispatch介面。 IFaxServer 也有下列類型的成員:

方法

IFaxServer介面具有這些方法。

 
IFaxServer::Connect

Connect 方法會將傳真用戶端應用程式連接到指定的傳真伺服器。
IFaxServer::CreateDocument

IFaxServer::CreateDocument 方法會為指定的 FaxServer 物件建立 FaxDoc 物件。 FaxDoc 物件可讓使用者建立及傳輸檔給一或多個傳真收件者。
IFaxServer::D isconnect

IFaxServer::D isconnect 方法會終止傳真用戶端應用程式與傳真伺服器的連線。
IFaxServer::get_ArchiveDirectory

IFaxServer::get_ArchiveDirectory 方法會擷取 FaxServer 物件的 ArchiveDirectory 屬性。 ArchiveDirectory 屬性是 Null 終止的字串,其中包含傳真伺服器儲存封存輸出傳真的位置。 (取得)
IFaxServer::get_ArchiveOutboundFaxes

會設定或擷取 FaxServer 物件的 ArchiveOutboundFaxes 屬性。 ArchiveOutboundFaxes 屬性是布林值,指出傳真伺服器是否封存傳出傳真傳輸。 (取得)
IFaxServer::get_Branding

設定或擷取 FaxServer 物件的 Branding 屬性。 Branding 屬性是布林值,指出傳真伺服器是否會在傳真傳輸頂端產生商標資訊。 (取得)
IFaxServer::get_DirtyDays

會設定或擷取 FaxServer 物件的 DirtyDays 屬性。 DirtyDays 屬性是傳真伺服器在傳真工作佇列中保留未傳送工作的天數。 (取得)
IFaxServer::get_DiscountRateEndHour

會設定或擷取 FaxServer 物件的 DiscountRateEndHour 屬性。 DiscountRateEndHour 屬性是代表折扣期間結束時數的數位。 折扣期間僅適用于傳出傳真傳輸。 (取得)
IFaxServer::get_DiscountRateEndMinute

會設定或擷取 FaxServer 物件的 DiscountRateEndMinute 屬性。 DiscountRateEndMinute 屬性是代表折扣期間結束分鐘的數位。 折扣期間僅適用于傳出傳真傳輸。 (取得)
IFaxServer::get_DiscountRateStartHour

會設定或擷取 FaxServer 物件的 DiscountRateStartHour 屬性。 DiscountRateStartHour 屬性是一個數位,代表折扣期間開始的小時。 折扣期間僅適用于傳出傳真傳輸。 (取得)
IFaxServer::get_DiscountRateStartMinute

會設定或擷取 FaxServer 物件的 DiscountRateStartMinute 屬性。 DiscountRateStartMinute 屬性是數位,代表折扣期間開始的分鐘數。 折扣期間僅適用于傳出傳真傳輸。 (取得)
IFaxServer::get_PauseServerQueue

會設定或擷取 FaxServer 物件的 PauseServerQueue 屬性。 PauseServerQueue 屬性是布林值,指出傳真伺服器是否已暫停傳真工作佇列。 (取得)
IFaxServer::get_Retries

會設定或擷取 FaxServer 物件的 Retries 屬性。 Retries 屬性是一個值,表示當初始傳輸失敗時,傳真伺服器嘗試重新傳輸傳出傳真的次數。 (取得)
IFaxServer::get_RetryDelay

會設定或擷取 FaxServer 物件的 RetryDelay 屬性。 RetryDelay 屬性是一個值,代表時間間隔,以分鐘為單位,傳真伺服器會在嘗試重新傳輸輸出傳真作業之前等候。 (取得)
IFaxServer::get_ServerCoverpage

設定或擷取 FaxServer 物件的 ServerCoverpage 屬性。 ServerCoverpage 屬性是布林值,指出傳真伺服器是否只允許使用通用封面。 (取得)
IFaxServer::get_ServerMapiProfile

會設定或擷取 FaxServer 物件的 ServerMapiProfile 屬性。 ServerMapiProfile 屬性是 Null 終止的字串,其中包含傳真伺服器用來路由傳入傳真傳輸的 MAPI 使用者設定檔。 (取得)
IFaxServer::get_UseDeviceTsid

會設定或擷取 FaxServer 物件的 UseDeviceTsid 屬性。 UseDeviceTsid 屬性是布林值,指出傳真伺服器是否使用裝置的傳輸站識別碼 (TSID) ,而不是使用者指定的 TSID。 (取得)
IFaxServer::GetJobs

GetJobs 方法會建立並初始化指定之 FaxServer 物件的 FaxJobs 物件。 FaxJobs 物件允許列舉連線傳真伺服器的目前佇列工作。
IFaxServer::GetPorts

GetPorts 方法會建立並初始化指定之 FaxServer 物件的 FaxPorts 物件。 FaxPorts 物件允許列舉連線傳真伺服器的傳真埠組態資訊。
IFaxServer::p ut_ArchiveDirectory

IFaxServer::get_ArchiveDirectory 方法會擷取 FaxServer 物件的 ArchiveDirectory 屬性。 ArchiveDirectory 屬性是 Null 終止的字串,其中包含傳真伺服器儲存封存輸出傳真的位置。 (Put)
IFaxServer::p ut_ArchiveOutboundFaxes

會設定或擷取 FaxServer 物件的 ArchiveOutboundFaxes 屬性。 ArchiveOutboundFaxes 屬性是布林值,指出傳真伺服器是否封存傳出傳真傳輸。 (Put)
IFaxServer::p ut_Branding

設定或擷取 FaxServer 物件的 Branding 屬性。 Branding 屬性是布林值,指出傳真伺服器是否會在傳真傳輸頂端產生商標資訊。 (Put)
IFaxServer::p ut_DirtyDays

會設定或擷取 FaxServer 物件的 DirtyDays 屬性。 DirtyDays 屬性是傳真伺服器在傳真工作佇列中保留未傳送工作的天數。 (Put)
IFaxServer::p ut_DiscountRateEndHour

會設定或擷取 FaxServer 物件的 DiscountRateEndHour 屬性。 DiscountRateEndHour 屬性是代表折扣期間結束時數的數位。 折扣期間僅適用于傳出傳真傳輸。 (Put)
IFaxServer::p ut_DiscountRateEndMinute

會設定或擷取 FaxServer 物件的 DiscountRateEndMinute 屬性。 DiscountRateEndMinute 屬性是代表折扣期間結束分鐘的數位。 折扣期間僅適用于傳出傳真傳輸。 (Put)
IFaxServer::p ut_DiscountRateStartHour

會設定或擷取 FaxServer 物件的 DiscountRateStartHour 屬性。 DiscountRateStartHour 屬性是一個數位,代表折扣期間開始的小時。 折扣期間僅適用于傳出傳真傳輸。 (Put)
IFaxServer::p ut_DiscountRateStartMinute

會設定或擷取 FaxServer 物件的 DiscountRateStartMinute 屬性。 DiscountRateStartMinute 屬性是數位,代表折扣期間開始的分鐘數。 折扣期間僅適用于傳出傳真傳輸。 (Put)
IFaxServer::p ut_PauseServerQueue

會設定或擷取 FaxServer 物件的 PauseServerQueue 屬性。 PauseServerQueue 屬性是布林值,指出傳真伺服器是否已暫停傳真工作佇列。 (Put)
IFaxServer::p ut_Retries

會設定或擷取 FaxServer 物件的 Retries 屬性。 Retries 屬性是一個值,表示當初始傳輸失敗時,傳真伺服器嘗試重新傳輸傳出傳真的次數。 (Put)
IFaxServer::p ut_RetryDelay

會設定或擷取 FaxServer 物件的 RetryDelay 屬性。 RetryDelay 屬性是一個值,代表時間間隔,以分鐘為單位,傳真伺服器會在嘗試重新傳輸輸出傳真作業之前等候。 (Put)
IFaxServer::p ut_ServerCoverpage

設定或擷取 FaxServer 物件的 ServerCoverpage 屬性。 ServerCoverpage 屬性是布林值,指出傳真伺服器是否只允許使用通用封面。 (Put)
IFaxServer::p ut_ServerMapiProfile

會設定或擷取 FaxServer 物件的 ServerMapiProfile 屬性。 ServerMapiProfile 屬性是 Null 終止的字串,其中包含傳真伺服器用來路由傳入傳真傳輸的 MAPI 使用者設定檔。 (Put)
IFaxServer::p ut_UseDeviceTsid

會設定或擷取 FaxServer 物件的 UseDeviceTsid 屬性。 UseDeviceTsid 屬性是布林值,指出傳真伺服器是否使用裝置的傳輸站識別碼 (TSID) ,而不是使用者指定的 TSID。 (Put)

備註

何時實作

您不應該實作此介面。 Microsoft 標準實作提供完整的功能。

使用時機

使用 IFaxServer 介面,連線到作用中傳真伺服器並中斷連線。 也請使用 介面來擷取和設定 FaxServer 物件的屬性,以及建立下列步驟中所列的物件。

若要連線到傳真伺服器,並建立其他傳真用戶端物件,請執行下列步驟:

  1. 呼叫 CoCreateInstance 函式以擷取 IFaxServer 介面的指標,並建立 FaxServer 物件的實例。
  2. 呼叫 IFaxServer::Connect 方法來起始與作用中傳真伺服器的連線。
  3. 取得連接之後,請呼叫下列方法來建立您需要的物件:
  4. 呼叫 IFaxServer::D isconnect 方法,以中斷與傳真伺服器的連線。
  5. 呼叫每個物件的 IUnknown::Release 方法,以允許物件自行解除配置。 如有必要,請再次呼叫 方法,以終結 IFaxPortsIFaxJobs 介面指標。
請注意,用戶端應用程式不應該呼叫 CoCreateInstance 函式來建立 FaxJobsFaxPortsFaxDoc 物件,或衍生自這些物件的物件。 如需建立和解除配置傳真用戶端物件的詳細資訊,請參閱每個個別介面主題列出的步驟,以及 傳真用戶端物件模型中包含的階層式圖表。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 faxcom.h

另請參閱

傳真服務用戶端 API 介面

適用于 Windows 2000 的傳真服務用戶端 API

IDispatch