ホーム › Devices.Tapi › ITAddressTranslation

ITAddressTranslation

COMIDispatch (デュアル)

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

IID0c4d8f03-8ddb-11d1-a09e-00805fc147d3継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 6

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

vtbl 7 HRESULT TranslateAddress(LPWSTR pAddressToTranslate, INT lCard, INT lTranslateOptions, ITAddressTranslationInfo** ppTranslated)

pAddressToTranslate	LPWSTR	in	変換対象のダイヤル可能アドレス(電話番号)を指定する。
lCard	INT	in	使用するテレフォニーカードのID。既定を使う場合は0を指定する。
lTranslateOptions	INT	in	変換動作を制御するオプションフラグ(LINETRANSLATEOPTION)を指定する。
ppTranslated	ITAddressTranslationInfo**	out	変換結果を保持するITAddressTranslationInfoインターフェイスを受け取る出力先。

vtbl 8 HRESULT TranslateDialog(INT_PTR hwndOwner, LPWSTR pAddressIn)

hwndOwner	INT_PTR	in	ダイヤルのプロパティダイアログの親ウィンドウハンドルを指定する。
pAddressIn	LPWSTR	in	ダイアログに初期表示するアドレス文字列を指定する。

vtbl 9 HRESULT EnumerateLocations(IEnumLocation** ppEnumLocation)

ppEnumLocation

IEnumLocation**

out

登録済みの所在地情報を列挙するIEnumLocationを受け取る出力先。

vtbl 10 HRESULT get_Locations(VARIANT* pVariant)

pVariant

VARIANT*

out

所在地情報のコレクションをVARIANT形式で受け取る出力先。

vtbl 11 HRESULT EnumerateCallingCards(IEnumCallingCard** ppEnumCallingCard)

ppEnumCallingCard

IEnumCallingCard**

out

登録済みのテレフォニーカードを列挙するIEnumCallingCardを受け取る出力先。

vtbl 12 HRESULT get_CallingCards(VARIANT* pVariant)

pVariant

VARIANT*

out

テレフォニーカードのコレクションをVARIANT形式で受け取る出力先。

HSP用 COM定義

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

出力引数:

#define global IID_ITAddressTranslation "{0C4D8F03-8DDB-11D1-A09E-00805FC147D3}"
#usecom global ITAddressTranslation IID_ITAddressTranslation "{}"
#comfunc global ITAddressTranslation_TranslateAddress       7 wstr,int,int,sptr
#comfunc global ITAddressTranslation_TranslateDialog        8 sptr,wstr
#comfunc global ITAddressTranslation_EnumerateLocations     9 sptr
#comfunc global ITAddressTranslation_get_Locations          10 var
#comfunc global ITAddressTranslation_EnumerateCallingCards  11 sptr
#comfunc global ITAddressTranslation_get_CallingCards       12 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITAddressTranslation "{0C4D8F03-8DDB-11D1-A09E-00805FC147D3}"
#usecom global ITAddressTranslation IID_ITAddressTranslation "{}"
#comfunc global ITAddressTranslation_TranslateAddress       7 wstr,int,int,sptr
#comfunc global ITAddressTranslation_TranslateDialog        8 sptr,wstr
#comfunc global ITAddressTranslation_EnumerateLocations     9 sptr
#comfunc global ITAddressTranslation_get_Locations          10 sptr
#comfunc global ITAddressTranslation_EnumerateCallingCards  11 sptr
#comfunc global ITAddressTranslation_get_CallingCards       12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。