IFaxServer 介面 (faxcom.h)

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

• 起始和終止與傳真伺服器連線的方法。
• 用來擷取及設定 FaxServer 物件的個別屬性值的屬性方法。
• 建立 FaxJobs、 FaxPorts 和 FaxDoc 物件的方法。

注意 傳真用戶端應用程式必須呼叫 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. 取得連接之後，請呼叫下列方法來建立您需要的物件：
   • 用來建立FaxJobs物件的IFaxServer：：GetJobs方法。 使用此物件建立 FaxJob 物件，並列舉與連線傳真伺服器相關聯的傳真工作。
   • 用來建立FaxPorts物件的IFaxServer：：GetPorts方法。 使用此物件來建立 FaxPort 物件，並列舉傳真伺服器連線的傳真埠組態資訊。
   • 用來建立FaxDoc物件的IFaxServer：：CreateDocument方法。 使用此物件來傳輸傳真，並擷取和設定 FaxDoc 物件的屬性。
4. 呼叫 IFaxServer：:D isconnect 方法，以中斷與傳真伺服器的連線。
5. 呼叫每個物件的 IUnknown：：Release 方法，以允許物件自行解除配置。 如有必要，請再次呼叫 方法，以終結 IFaxPorts 或 IFaxJobs 介面指標。

請注意，用戶端應用程式不應該呼叫 CoCreateInstance 函式來建立 FaxJobs、 FaxPorts 或 FaxDoc 物件，或衍生自這些物件的物件。 如需建立和解除配置傳真用戶端物件的詳細資訊，請參閱每個個別介面主題列出的步驟，以及 傳真用戶端物件模型中包含的階層式圖表。

需求

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

另請參閱

傳真服務用戶端 API 介面

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

IDispatch