(faxcom.h) IFaxPorts 介面

傳真用戶端應用程式會使用 IFaxPorts 雙重介面來存取衍生自 FaxServer 物件的 FaxPort 物件。 介面會列舉與作用中傳真伺服器連線的埠組態資訊。 FaxPorts 物件是FaxPort物件的集合。

IFaxPorts 介面包含可讓傳真用戶端應用程式執行下列工作的方法。

• 擷取與傳真伺服器相關聯的傳真埠數目。
• 建立及擷取 FaxPort 物件的 IFaxPort 介面指標。

繼承

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

方法

IFaxPorts 介面具有這些方法。

IFaxPorts：：get_Count IFaxPorts：：get_Count 方法會擷取連接至連線機傳真伺服器的傳真埠數目。
IFaxPorts：：get_Item IFaxPorts：：get_Item 方法會為指定的傳真埠建立 FaxPort 物件。 對象允許列舉與傳真伺服器特定連線的埠組態資訊。

備註

何時實作

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

使用時機

使用 IFaxPorts 介面來建立和擷取 FaxPort 物件的 IFaxPort 介面指標。 每個與連線傳真伺服器相關聯的埠都有一個FaxPort物件。

若要建立 FaxPort 物件的實例，請執行下列步驟。 請注意，傳真用戶端應用程式不應該呼叫 CoCreateInstance 函式來擷取 IFaxPort 介面指標。

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

規格需求

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

另請參閱

傳真服務用戶端 API 介面

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

IDispatch