IFaxInboundRouting
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
IFaxInboundRouting インターフェイスは、FAX クライアント アプリケーションが、FAX サービスに登録されている受信ルーティング拡張機能 (FaxInboundRoutingExtensions オブジェクトで表されます) と、それらの拡張機能が公開するルーティング メソッド (FaxInboundRoutingMethods オブジェクトで表されます) にアクセスするために使用する構成オブジェクトを定義します。
解説(Remarks)
IFaxInboundRouting の既定の実装は、FaxInboundRouting オブジェクトとして提供されます。
メソッド 2
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
GetExtensions メソッドは、FAX サービスに登録されている受信ルーティング拡張機能のコレクションを取得します。
| pFaxInboundRoutingExtensions | IFaxInboundRoutingExtensions** | out | IFaxInboundRoutingExtensions インターフェイスへのポインターのアドレスです。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説(Remarks)
このメソッドを使用するには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。
IFaxInboundRouting::GetMethods メソッドは、現在 FAX サービスに登録されているすべての受信ルーティング拡張機能が公開する、すべての受信ルーティング メソッドの順序付きコレクションを取得します。
| pFaxInboundRoutingMethods | IFaxInboundRoutingMethods** | out | IFaxInboundRoutingMethods インターフェイスへのポインターのアドレスです。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説(Remarks)
順序は、各ルーティング メソッドの Priority プロパティに基づきます。この優先度は、FAX サービスが FAX ジョブを受信したときにルーティング メソッドを呼び出す順序に関連付けられています。
このメソッドを使用するには、ユーザーが farQUERY_CONFIG アクセス権を持っている必要があります。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IFaxInboundRouting "{8148C20F-9D52-45B1-BF96-38FC12713527}"
#usecom global IFaxInboundRouting IID_IFaxInboundRouting "{}"
#comfunc global IFaxInboundRouting_GetExtensions 7 sptr
#comfunc global IFaxInboundRouting_GetMethods 8 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。