IFaxPort 介面 (faxcom.h)

傳真用戶端應用程式會使用 IFaxPort 雙重介面來存取連線傳真伺服器上的傳真埠組態資訊。 IFaxPort 介面包含下列方法。

• 建立 FaxRoutingMethods 物件和 FaxStatus 物件的方法。
• 屬性方法，可設定及擷取與 IFaxPorts 介面所擷取之 FaxPort 對象相關聯的個別屬性值。 FaxPorts 物件是FaxPort物件的集合。

繼承

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

方法

IFaxPort 介面具有這些方法。

IFaxPort：：get_CanModify IFaxPort：：get_CanModify 屬性是布爾值，指出使用者是否有權修改傳真埠的組態資訊。
IFaxPort：：get_Csid IFaxPort：：get_Csid 屬性是以 Null 結尾的字串，其中包含與傳真埠相關聯的 (CSID) 所呼叫的月臺標識符。 (取得)
IFaxPort：：get_DeviceId IFaxPort：：get_DeviceId 屬性是數位，代表傳真埠的永久行標識符。
IFaxPort：：get_Name IFaxPort：：get_Name 屬性是 Null 終止的字串，其中包含傳真埠的使用者易記顯示名稱。
IFaxPort：：get_Priority IFaxPort：：get_Priority 屬性是數位，代表指定之傳真埠的傳輸優先順序。 優先順序會決定可用傳真裝置傳送傳出傳輸的相對順序。 (取得)
IFaxPort：：get_Receive IFaxPort：：get_Receive 屬性是布爾值，指出是否啟用指定的傳真埠來接收傳真。 (取得)
IFaxPort：：get_Rings IFaxPort：：get_Rings 屬性代表連入傳真通話應該在傳真埠接聽通話之前等候的通道數目。 (取得)
IFaxPort：：get_Send IFaxPort：：get_Send 屬性是布爾值，指出是否啟用傳真埠來傳送傳真。 (取得)
IFaxPort：：get_Tsid IFaxPort：：get_Tsid 屬性是以 Null 結尾的字串，其中包含與傳真埠相關聯的傳輸月臺標識元 (TSID) 。 (取得)
IFaxPort：：GetRoutingMethods IFaxPort：：GetRoutingMethods 介面方法會建立父 FaxPort 物件的 FaxRoutingMethods 物件。
IFaxPort：：GetStatus IFaxPort：：GetStatus 方法會建立父 FaxPort 物件的 FaxStatus 物件。 FaxStatus 物件包含傳真埠的目前狀態。
IFaxPort：:p ut_Csid IFaxPort：：get_Csid 屬性是以 Null 結尾的字串，其中包含與傳真埠相關聯的 (CSID) 所呼叫的月臺標識符。 (Put)
IFaxPort：:p ut_Priority IFaxPort：：get_Priority 屬性是數位，代表指定之傳真埠的傳輸優先順序。 優先順序會決定可用傳真裝置傳送傳出傳輸的相對順序。 (Put)
IFaxPort：:p ut_Receive IFaxPort：：get_Receive 屬性是布爾值，指出是否啟用指定的傳真埠來接收傳真。 (Put)
IFaxPort：:p ut_Rings IFaxPort：：get_Rings 屬性代表連入傳真通話應該在傳真埠接聽通話之前等候的通道數目。 (Put)
IFaxPort：:p ut_Send IFaxPort：：get_Send 屬性是布爾值，指出是否啟用傳真埠來傳送傳真。 (Put)
IFaxPort：:p ut_Tsid IFaxPort：：get_Tsid 屬性是以 Null 結尾的字串，其中包含與傳真埠相關聯的傳輸月臺標識元 (TSID) 。 (Put)

備註

注意傳真用戶端應用程式可以在呼叫以 IFaxPort：：:p ut_ 開頭的任何方法之前呼叫 IFaxPort：：get_CanModify 屬性，以確保用戶端可以存取以修改指定的傳真埠。

 

實作時機

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

使用時機

使用 IFaxPort 介面來擷取及設定 FaxPort 物件的屬性。

用戶端應用程式不應該呼叫 CoCreateInstance 函式來擷取 IFaxPort 介面指標。 相反地，應用程式必須執行下列步驟來建立 FaxPort 對象的實例。

1. 呼叫 CoCreateInstance 函式以擷取 IFaxServer 介面的指標。
2. 呼叫 IFaxServer：：Connect 方法來連線到作用中的傳真伺服器。
3. 呼叫 IFaxServer：：GetPorts 方法，為連接的傳真伺服器建立和初始化 FaxPorts 物件。
4. 呼叫 IFaxPorts：：get_Count 方法，然後呼叫 IFaxPorts：：get_Item 方法來擷取每個子傳真埠物件的 IDispatch 介面指標。 (您也可以呼叫 IUnknown：：QueryInterface 方法來擷取 IFaxPort 介面指標。)
5. 使用 IDispatch 介面指標來呼叫 IFaxPort 介面方法。
6. 呼叫 IFaxServer：:D isconnect 方法，以中斷與傳真伺服器的連線。
7. 針對每個FaxPort物件呼叫IUnknown：：Release方法，以允許物件自行解除分配，並再次終結IFaxPorts 介面指標。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	faxcom.h

另請參閱

傳真服務用戶端 API 介面

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

IDispatch