ホーム › Devices.Fax › IFaxRecipient

IFaxRecipient

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID9a3da3a0-538d-42b6-9444-aaa57d0ce2bc継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

IFaxRecipient インターフェイスは、FAX クライアントアプリケーションが FAX 受信者の個人情報を取得および設定するために使用する FaxRecipient メッセージングオブジェクトを定義します。

解説(Remarks)

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

メソッド 4

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

vtbl 7 HRESULT get_FaxNumber(LPWSTR* pbstrFaxNumber)

IFaxRecipient::get_FaxNumber プロパティは、受信者に関連付けられた FAX 番号を格納する null 終端文字列です。(Get)

pbstrFaxNumber

LPWSTR*

out

宛先のFAX番号を受け取るBSTR出力先。

解説(Remarks)

この文字列に正規形式の FAX 番号 (Telephony Application Programming Interface (TAPI) ドキュメントの Address トピックで定義されています。Canonical Addresses の項を参照してください) が含まれている場合は、送信ルーティング規則が適用されます。それ以外の場合は、最初に利用可能なデバイスが使用され、FAX 番号は文字列に記述されているとおりにダイヤルされます。

vtbl 8 HRESULT put_FaxNumber(LPWSTR bstrFaxNumber)

IFaxRecipient::get_FaxNumber プロパティは、受信者に関連付けられた FAX 番号を格納する null 終端文字列です。(Put)

bstrFaxNumber

LPWSTR

設定する宛先のFAX番号。

解説(Remarks)

vtbl 9 HRESULT get_Name(LPWSTR* pbstrName)

IFaxRecipient::get_Name プロパティは、受信者の名前を格納する null 終端文字列です。(Get)

pbstrName

LPWSTR*

out

宛先の氏名を受け取るBSTR出力先。

vtbl 10 HRESULT put_Name(LPWSTR bstrName)

IFaxRecipient::get_Name プロパティは、受信者の名前を格納する null 終端文字列です。(Put)

bstrName

LPWSTR

設定する宛先の氏名。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IFaxRecipient "{9A3DA3A0-538D-42B6-9444-AAA57D0CE2BC}"
#usecom global IFaxRecipient IID_IFaxRecipient "{}"
#comfunc global IFaxRecipient_get_FaxNumber  7 var
#comfunc global IFaxRecipient_put_FaxNumber  8 wstr
#comfunc global IFaxRecipient_get_Name       9 var
#comfunc global IFaxRecipient_put_Name       10 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IFaxRecipient "{9A3DA3A0-538D-42B6-9444-AAA57D0CE2BC}"
#usecom global IFaxRecipient IID_IFaxRecipient "{}"
#comfunc global IFaxRecipient_get_FaxNumber  7 sptr
#comfunc global IFaxRecipient_put_FaxNumber  8 wstr
#comfunc global IFaxRecipient_get_Name       9 sptr
#comfunc global IFaxRecipient_put_Name       10 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。