IFaxServer 介面 (faxcom.h)
傳真用戶端應用程式會使用 IFaxServer 雙重介面來管理傳真服務的連線。 介面會擷取並設定 FaxServer 物件的相關資訊;例如,重新傳輸、商標、封存和封面的設定;折扣率週期;和傳真伺服器佇列的狀態。 IFaxServer介面包含下列方法:
注意 傳真用戶端應用程式必須呼叫 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 物件的屬性,以及建立下列步驟中所列的物件。若要連線到傳真伺服器,並建立其他傳真用戶端物件,請執行下列步驟:
- 呼叫 CoCreateInstance 函式以擷取 IFaxServer 介面的指標,並建立 FaxServer 物件的實例。
- 呼叫 IFaxServer::Connect 方法來起始與作用中傳真伺服器的連線。
- 取得連接之後,請呼叫下列方法來建立您需要的物件:
- 用來建立FaxJobs物件的IFaxServer::GetJobs方法。 使用此物件建立 FaxJob 物件,並列舉與連線傳真伺服器相關聯的傳真工作。
- 用來建立FaxPorts物件的IFaxServer::GetPorts方法。 使用此物件來建立 FaxPort 物件,並列舉傳真伺服器連線的傳真埠組態資訊。
- 用來建立FaxDoc物件的IFaxServer::CreateDocument方法。 使用此物件來傳輸傳真,並擷取和設定 FaxDoc 物件的屬性。
- 呼叫 IFaxServer::D isconnect 方法,以中斷與傳真伺服器的連線。
- 呼叫每個物件的 IUnknown::Release 方法,以允許物件自行解除配置。 如有必要,請再次呼叫 方法,以終結 IFaxPorts 或 IFaxJobs 介面指標。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | faxcom.h |