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 對象的實例。
- 呼叫 CoCreateInstance 函式以擷取 IFaxServer 介面的指標。
- 呼叫 IFaxServer：：Connect 方法來連線到作用中的傳真伺服器。
- 呼叫 IFaxServer：：GetPorts 方法，為連接的傳真伺服器建立和初始化 FaxPorts 物件。
- 呼叫 IFaxPorts：：get_Count 方法，然後呼叫 IFaxPorts：：get_Item 方法來擷取每個子傳真埠物件的 IDispatch 介面指標。 (您也可以呼叫 IUnknown：：QueryInterface 方法來擷取 IFaxPort 介面指標。)
- 使用 IDispatch 介面指標來呼叫 IFaxPort 介面方法。
- 呼叫 IFaxServer：:D isconnect 方法，以中斷與傳真伺服器的連線。
- 針對每個FaxPort物件呼叫IUnknown：：Release方法，以允許物件自行解除分配，並再次終結IFaxPorts 介面指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | faxcom.h |