IFaxRoutingMethod デュアル インターフェイスは、接続されている FAX サーバー上の FAX ポートの FAX ルーティング構成情報を取得するために、FAX クライアント アプリケーションによって使用されます。 FaxRoutingMethods オブジェクトは、FAXRoutingMethod オブジェクトのコレクションです。
IFaxRoutingMethod インターフェイスには、次のインターフェイス メソッドが含まれています。
- 特定の FaxPort オブジェクトの FAX ルーティング メソッドを取得、有効、または無効にするプロパティ メソッド。 (FAX ルーティング方法は、FAX ルーティング拡張機能 DLL によって定義されます)。
- FaxRoutingMethod オブジェクトの属性 (ルーティング メソッドをエクスポートする DLL の名前など) を取得するプロパティ メソッド。 属性には、ルーティング方法を一意に識別する GUID と関数名、ルーティング メソッドのユーザー フレンドリ名も含まれます。
ルーティング方法は、ポートで FAX を受信するたびに実行されるアクションです。 ポートで FAX 受信が有効になっていない場合、FAX サービスはポートに関連付けられているルーティング方法を無視します。 有効なルーティング方法のみが、FAX の受信時に実行されます。
継承
IFaxRoutingMethod インターフェイスは、IDispatch インターフェイスから継承されます。
メソッド
IFaxRoutingMethod インターフェイスには、これらのメソッドがあります。
IFaxRoutingMethod::get_DeviceId IFaxRoutingMethod::get_DeviceId プロパティは、FAX ポートの回線識別子を表す数値です。 |
IFaxRoutingMethod::get_DeviceName IFaxRoutingMethod::get_DeviceName プロパティは、FAX ポートのわかりやすい表示名を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_Enable IFaxRoutingMethod::get_Enable プロパティは、特定の FAX ポートで FAX ルーティング方法が有効になっているかどうかを示すブール値です。 (Get) |
IFaxRoutingMethod::get_ExtensionName IFaxRoutingMethod::get_ExtensionName プロパティは、指定された FAX ルーティング方法を実装する FAX ルーティング拡張 DLL のユーザー フレンドリ名を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_FriendlyName IFaxRoutingMethod::get_FriendlyName プロパティは、FAX ルーティング メソッドのわかりやすい名前を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_FunctionName IFaxRoutingMethod::get_FunctionName プロパティは、特定の FAX ルーティング プロシージャを実行する関数の名前を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_Guid IFaxRoutingMethod::get_Guid プロパティは、FAX ルーティング 方法を一意に識別する GUID を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_ImageName IFaxRoutingMethod::get_ImageName プロパティは、FAX ルーティング方法を実装する FAX ルーティング拡張 DLL の実行可能イメージ名を含む null で終わる文字列です。 |
IFaxRoutingMethod::get_RoutingData IFaxRoutingMethod::get_RoutingData プロパティは、着信 FAX 送信のルーティング文字列を含む null で終わる文字列です。 |
IFaxRoutingMethod::p ut_Enable IFaxRoutingMethod::get_Enable プロパティは、特定の FAX ポートで FAX ルーティング方法が有効になっているかどうかを示すブール値です。 (Put) |
注釈
実装するタイミング
このインターフェイスは実装しないでください。 Microsoft 標準実装では、完全な機能が提供されます。使用するタイミング
IFaxRoutingMethod インターフェイスを使用して、特定の FAX ポートで FAX ルーティング方法を有効または無効にし、FaxRoutingMethod オブジェクトのプロパティを取得および設定します。 指定した FAX ポートに関連付けられている各ルーティング 方法に対して 1 つの FaxRoutingMethod オブジェクトがあります。クライアント アプリケーションは 、CoCreateInstance 関数を呼び出して IFaxRoutingMethod インターフェイス ポインターを取得しないでください。 代わりに、アプリケーションで次の手順を実行して FaxRoutingMethod オブジェクトのインスタンスを作成する必要があります。
- CoCreateInstance 関数を呼び出して、IFaxServer インターフェイスへのポインターを取得します。
- IFaxServer::Connect メソッドを呼び出して、アクティブな FAX サーバーに接続します。
- IFaxServer::GetPorts メソッドを呼び出して、接続されている FAX サーバーの FaxPorts オブジェクトを作成および初期化します。
- IFaxPorts::get_Count メソッドを呼び出し、次に IFaxPorts::get_Item メソッドを呼び出して、各子 FaxPort オブジェクトの IDispatch インターフェイス ポインターを取得します。 ( IUnknown::QueryInterface メソッドを呼び出して 、IFaxPort インターフェイス ポインターを取得することもできます)。
- IDispatch インターフェイス ポインターを使用して IFaxPort::GetRoutingMethods インターフェイス メソッドを呼び出し、FaxRoutingMethods オブジェクトへの IDispatch インターフェイス ポインターを取得します。
- IFaxRoutingMethods::get_Count メソッドを呼び出し、IFaxRoutingMethods::get_Item メソッドを呼び出して、各子 FaxRoutingMethod オブジェクトの IDispatch インターフェイス ポインターを取得します。
- IFaxRoutingMethod インターフェイス メソッドを呼び出すには、IDispatch インターフェイス ポインターを使用します。
- FAX サーバーから切断するには、 IFaxServer::D isconnect メソッドを呼び出します。
- FaxRoutingMethod オブジェクトごとに IUnknown::Release メソッドを呼び出して、オブジェクト自体の割り当てを解除できるようにします。 また、 FaxPort オブジェクトごとに IUnknown::Release を呼び出し、 IFaxPorts インターフェイス ポインターを破棄します。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | faxcom.h |