共用方式為


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 物件的實例。

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

規格需求

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

另請參閱

傳真服務用戶端 API 介面

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

IDispatch