IFaxRoutingMethod 介面 (faxcom.h)
傳真用戶端應用程式會使用 IFaxRoutingMethod 雙重介面來擷取已連線傳真伺服器上傳真埠的傳真路由設定資訊。 FaxRoutingMethods物件是FaxRoutingMethod物件的集合。
IFaxRoutingMethod介面包含下列介面方法。
- 要擷取、啟用或停用特定 FaxPort 物件的傳真路由方法的屬性方法。 (傳真路由方法是由傳真路由延伸模組 DLL.)
- 用來擷取 FaxRoutingMethod 物件之屬性的屬性方法,例如匯出路由方法的 DLL 名稱。 屬性也包含可唯一識別路由方法的 GUID 和函式名稱,以及路由方法的使用者易記名稱。
路由方法是每次在埠上收到傳真時所執行的動作。 如果未在埠上啟用傳真接收,傳真服務會忽略與埠相關聯的路由方法。 只有在收到傳真時,才會執行啟用的路由方法。
繼承
IFaxRoutingMethod介面繼承自 IDispatch 介面。
方法
IFaxRoutingMethod介面具有這些方法。
IFaxRoutingMethod::get_DeviceId IFaxRoutingMethod::get_DeviceId 屬性是數位,代表傳真埠的行識別碼。 |
IFaxRoutingMethod::get_DeviceName IFaxRoutingMethod::get_DeviceName 屬性是以 Null 結尾的字串,其中包含傳真埠的使用者易記顯示名稱。 |
IFaxRoutingMethod::get_Enable IFaxRoutingMethod::get_Enable 屬性是布林值,指出是否在特定傳真埠上啟用傳真路由方法。 (取得) |
IFaxRoutingMethod::get_ExtensionName IFaxRoutingMethod::get_ExtensionName 屬性是 null 終止的字串,其中包含實作指定傳真路由方法之傳真路由延伸模組 DLL 的使用者易記名稱。 |
IFaxRoutingMethod::get_FriendlyName IFaxRoutingMethod::get_FriendlyName 屬性是以 Null 結尾的字串,其中包含傳真路由方法的使用者易記名稱。 |
IFaxRoutingMethod::get_FunctionName IFaxRoutingMethod::get_FunctionName 屬性是 null 終止的字串,其中包含執行特定傳真路由程式的函式名稱。 |
IFaxRoutingMethod::get_Guid IFaxRoutingMethod::get_Guid 屬性是 Null 終止的字串,其中包含可唯一識別傳真路由方法的 GUID。 |
IFaxRoutingMethod::get_ImageName IFaxRoutingMethod::get_ImageName 屬性是以 Null 結尾的字串,其中包含實作傳真路由方法之傳真路由延伸模組 DLL 的可執行影像名稱。 |
IFaxRoutingMethod::get_RoutingData IFaxRoutingMethod::get_RoutingData 屬性是 Null 終止的字串,其中包含傳入傳真傳輸的路由字串。 |
IFaxRoutingMethod::p ut_Enable IFaxRoutingMethod::get_Enable 屬性是布林值,指出是否在特定傳真埠上啟用傳真路由方法。 (Put) |
備註
實作時機
您不應該實作這個介面。 Microsoft 標準實作提供完整的功能。使用時機
使用 IFaxRoutingMethod 介面在特定傳真埠上啟用或停用傳真路由方法,以及擷取和設定 FaxRoutingMethod 物件的屬性。 每個與指定傳真埠相關聯的路由方法都有一個 FaxRoutingMethod 物件。用戶端應用程式不應該呼叫 CoCreateInstance 函式來擷取 IFaxRoutingMethod 介面指標。 相反地,應用程式必須執行下列步驟來建立 FaxRoutingMethod 物件的實例。
- 呼叫 CoCreateInstance 函式以擷取 IFaxServer 介面的指標。
- 呼叫 IFaxServer::Connect 方法來連線到作用中的傳真伺服器。
- 呼叫 IFaxServer::GetPorts 方法,為連接的傳真伺服器建立和初始化 FaxPorts 物件。
- 呼叫IFaxPorts::get_Count方法,然後呼叫IFaxPorts::get_Item方法來擷取每個子傳真埠物件的IDispatch介面指標。 (您也可以呼叫 IUnknown::QueryInterface 方法來擷取 IFaxPort 介面指標。)
- 使用 IDispatch 介面指標呼叫 IFaxPort::GetRoutingMethods 介面方法,以擷取 FaxRoutingMethods 物件的 IDispatch 介面指標。
- 呼叫IFaxRoutingMethods::get_Count方法,然後呼叫IFaxRoutingMethods::get_Item方法來擷取每個子系 FaxRoutingMethod物件的IDispatch介面指標。
- 使用 IDispatch 介面指標來呼叫 IFaxRoutingMethod 介面方法。
- 呼叫 IFaxServer::D isconnect 方法,以中斷與傳真伺服器的連線。
- 針對每個FaxRoutingMethod物件呼叫IUnknown::Release方法,以允許物件解除配置本身。 同時針對每個 FaxPort 物件呼叫 IUnknown::Release,並終結 IFaxPorts 介面指標。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | Windows |
標頭 | faxcom.h |