Win32 API 日本語リファレンス
ホーム › Devices.Fax › IFaxOutboundRoutingGroup

IFaxOutboundRoutingGroup

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDca6289a1-7e25-4f87-9a0b-93365734962c継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IFaxOutboundRoutingGroup インターフェイスは、個々の FAX 送信ルーティンググループに関する情報を取得するために FAX クライアントアプリケーションが使用する構成オブジェクトを表します。

解説(Remarks)

IFaxOutboundRoutingGroup の既定の実装は、FaxOutboundRoutingGroup オブジェクトとして提供されます。

メソッド 3

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Name(LPWSTR* pbstrName)

Name プロパティは、送信ルーティンググループの名前を指定する null 終端文字列です。

pbstrNameLPWSTR*out送信ルーティンググループの名前を受け取るBSTRポインタ。
vtbl 8 HRESULT get_Status(FAX_GROUP_STATUS_ENUM* pStatus)

Status プロパティは、送信ルーティンググループ内の FAX デバイスの全体的な状態を示します。

pStatusFAX_GROUP_STATUS_ENUM*outグループの状態を表すFAX_GROUP_STATUS_ENUM値を受け取るポインタ。全デバイス有効/一部無効等を示す。

解説(Remarks)

グループにデバイスを追加したり、グループからデバイスを削除したりしても、グループの状態は変化しません。

vtbl 9 HRESULT get_DeviceIds(IFaxDeviceIds** pFaxDeviceIds)

DeviceIds プロパティは、送信ルーティンググループに参加しているデバイス ID の順序付きコレクションを表すインターフェイスを取得します。

pFaxDeviceIdsIFaxDeviceIds**outグループに属するデバイスIDのコレクションを表すIFaxDeviceIdsインターフェイスを受け取るポインタ。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IFaxOutboundRoutingGroup "{CA6289A1-7E25-4F87-9A0B-93365734962C}"
#usecom global IFaxOutboundRoutingGroup IID_IFaxOutboundRoutingGroup "{}"
#comfunc global IFaxOutboundRoutingGroup_get_Name       7 var
#comfunc global IFaxOutboundRoutingGroup_get_Status     8 var
#comfunc global IFaxOutboundRoutingGroup_get_DeviceIds  9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。