ホーム › Devices.Tapi › ITForwardInformation2

ITForwardInformation2

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

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

IID5229b4ed-b260-4382-8e1a-5df3a8a4ccc0継承元ITForwardInformation呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl14

公式ドキュメント

ITForwardInformation2 インターフェイスは、転送情報を制御するための追加メソッドを公開します。基本的な転送制御メソッドについては ITForwardInformation を参照してください。

メソッド 4

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

vtbl 14 HRESULT SetForwardType2(INT ForwardType, LPWSTR pDestAddress, INT DestAddressType, LPWSTR pCallerAddress, INT CallerAddressType)

SetForwardType2 メソッドは、発信者アドレスで指定される現在の転送モードを設定します。

ForwardType	INT	in	設定する回線転送種別。
pDestAddress	LPWSTR	in	宛先アドレスの BSTR 表現へのポインター。
DestAddressType	INT	in	宛先のアドレス種別。
pCallerAddress	LPWSTR	in	発信者アドレスの BSTR 表現へのポインター。
CallerAddressType	INT	in	発信者のアドレス種別。

戻り値

このメソッドは次のいずれかの値を返します。

戻り値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	ForwardType、DestAddressType、または CallerAddressType が無効です。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。
E_POINTER	pDestAddress または pCallerAddress パラメーターが有効なポインターではありません。

vtbl 15 HRESULT GetForwardType2(INT ForwardType, LPWSTR* ppDestinationAddress, INT* pDestAddressType, LPWSTR* ppCallerAddress, INT* pCallerAddressType)

GetForwardType2 メソッドは、発信者アドレスで指定される現在の転送モードを取得します。

ForwardType	INT	in	取得する回線転送種別。
ppDestinationAddress	LPWSTR*	out	宛先アドレスの BSTR 表現へのポインター。
pDestAddressType	INT*	out	宛先のアドレス種別。
ppCallerAddress	LPWSTR*	out	発信者アドレスの BSTR 表現へのポインター。
pCallerAddressType	INT*	out	発信者のアドレス種別。

戻り値

このメソッドは次のいずれかの値を返します。

戻り値	説明
S_OK	メソッドは成功しました。
E_INVALIDARG	ForwardType、pDestAddressType、または pCallerAddressType パラメーターが無効です。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。
E_POINTER	ppDestinationAddress、pDestAddressType、pCallerAddressType、または ppCallerAddress パラメーターが有効なポインターではありません。

vtbl 16 HRESULT get_ForwardTypeDestinationAddressType(INT ForwardType, INT* pDestAddressType)

get_ForwardTypeDestinationAddressType メソッドは、指定した転送種別に対する宛先アドレス種別を取得します。

ForwardType	INT	in	取得する回線転送種別。
pDestAddressType	INT*	out	宛先のアドレス種別。

戻り値

このメソッドは次のいずれかの値を返します。

値	意味
S_OK	メソッドは成功しました。
E_INVALIDARG	ForwardType パラメーターが無効です。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。
E_POINTER	pDestAddressType パラメーターが有効なポインターではありません。

vtbl 17 HRESULT get_ForwardTypeCallerAddressType(INT Forwardtype, INT* pCallerAddressType)

get_ForwardTypeCallerAddressType メソッドは、指定した転送種別に対する発信者アドレス種別を取得します。

Forwardtype	INT	in	取得する回線転送種別。
pCallerAddressType	INT*	out	発信者のアドレス種別。

戻り値

このメソッドは次のいずれかの値を返します。

値	意味
S_OK	メソッドは成功しました。
E_INVALIDARG	Forwardtype パラメーターが無効です。
E_OUTOFMEMORY	操作を実行するのに十分なメモリがありません。
E_POINTER	pCallerAddressType パラメーターが有効なポインターではありません。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ITForwardInformation2 "{5229B4ED-B260-4382-8E1A-5DF3A8A4CCC0}"
#usecom global ITForwardInformation2 IID_ITForwardInformation2 "{}"
#comfunc global ITForwardInformation2_SetForwardType2                        14 int,wstr,int,wstr,int
#comfunc global ITForwardInformation2_GetForwardType2                        15 int,var,var,var,var
#comfunc global ITForwardInformation2_get_ForwardTypeDestinationAddressType  16 int,var
#comfunc global ITForwardInformation2_get_ForwardTypeCallerAddressType       17 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITForwardInformation2 "{5229B4ED-B260-4382-8E1A-5DF3A8A4CCC0}"
#usecom global ITForwardInformation2 IID_ITForwardInformation2 "{}"
#comfunc global ITForwardInformation2_SetForwardType2                        14 int,wstr,int,wstr,int
#comfunc global ITForwardInformation2_GetForwardType2                        15 int,sptr,sptr,sptr,sptr
#comfunc global ITForwardInformation2_get_ForwardTypeDestinationAddressType  16 int,sptr
#comfunc global ITForwardInformation2_get_ForwardTypeCallerAddressType       17 int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。