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

ITAddress2

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDb0ae5d9b-be51-46c9-b0f7-dfa8a22a8bc4継承元ITAddress呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl22

メソッド 10

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

vtbl 22 HRESULT get_Phones(VARIANT* pPhones)
pPhonesVARIANT*outこのアドレスに関連付けられた電話機のコレクションをVARIANTで受け取る出力先。
vtbl 23 HRESULT EnumeratePhones(IEnumPhone** ppEnumPhone)
ppEnumPhoneIEnumPhone**out関連付けられた電話機を列挙するIEnumPhoneを受け取る出力先。
vtbl 24 HRESULT GetPhoneFromTerminal(ITTerminal* pTerminal, ITPhone** ppPhone)
pTerminalITTerminal*in対応する電話機を求める基準となるITTerminal。
ppPhoneITPhone**outそのターミナルに対応するITPhoneを受け取る出力先。
vtbl 25 HRESULT get_PreferredPhones(VARIANT* pPhones)
pPhonesVARIANT*out優先的に使用される電話機のコレクションをVARIANTで受け取る出力先。
vtbl 26 HRESULT EnumeratePreferredPhones(IEnumPhone** ppEnumPhone)
ppEnumPhoneIEnumPhone**out優先電話機を列挙するIEnumPhoneを受け取る出力先。
vtbl 27 HRESULT get_EventFilter(TAPI_EVENT TapiEvent, INT lSubEvent, VARIANT_BOOL* pEnable)
TapiEventTAPI_EVENTin対象とするイベント分類を示すTAPI_EVENT列挙値。
lSubEventINTin対象とするサブイベント種別を示す値。
pEnableVARIANT_BOOL*out当該イベントが有効ならVARIANT_TRUEを受け取る出力先。
vtbl 28 HRESULT put_EventFilter(TAPI_EVENT TapiEvent, INT lSubEvent, VARIANT_BOOL bEnable)
TapiEventTAPI_EVENTin設定対象のイベント分類を示すTAPI_EVENT列挙値。
lSubEventINTin設定対象のサブイベント種別を示す値。
bEnableVARIANT_BOOLinVARIANT_TRUEで当該イベント通知を有効化する真偽値。
vtbl 29 HRESULT DeviceSpecific(ITCallInfo* pCall, BYTE* pParams, DWORD dwSize)
pCallITCallInfo*inデバイス固有操作の対象となる通話ITCallInfo。NULL可。
pParamsBYTE*inサービスプロバイダーに渡すデバイス固有データのバイトバッファ。
dwSizeDWORDinpParamsバッファのバイトサイズ。
vtbl 30 HRESULT DeviceSpecificVariant(ITCallInfo* pCall, VARIANT varDevSpecificByteArray)
pCallITCallInfo*inデバイス固有操作の対象となる通話ITCallInfo。NULL可。
varDevSpecificByteArrayVARIANTinデバイス固有データをバイト配列として保持するVARIANT。
vtbl 31 HRESULT NegotiateExtVersion(INT lLowVersion, INT lHighVersion, INT* plExtVersion)
lLowVersionINTin受け入れ可能な拡張バージョンの下限を指定する。
lHighVersionINTin受け入れ可能な拡張バージョンの上限を指定する。
plExtVersionINT*outネゴシエートされた拡張バージョン番号を受け取る出力先。

HSP用 COM定義

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

出力引数: 
#define global IID_ITAddress2 "{B0AE5D9B-BE51-46C9-B0F7-DFA8A22A8BC4}"
#usecom global ITAddress2 IID_ITAddress2 "{}"
#comfunc global ITAddress2_get_Phones                22 var
#comfunc global ITAddress2_EnumeratePhones           23 sptr
#comfunc global ITAddress2_GetPhoneFromTerminal      24 sptr,sptr
#comfunc global ITAddress2_get_PreferredPhones       25 var
#comfunc global ITAddress2_EnumeratePreferredPhones  26 sptr
#comfunc global ITAddress2_get_EventFilter           27 int,int,var
#comfunc global ITAddress2_put_EventFilter           28 int,int,int
#comfunc global ITAddress2_DeviceSpecific            29 sptr,var,int
#comfunc global ITAddress2_DeviceSpecificVariant     30 sptr,int
#comfunc global ITAddress2_NegotiateExtVersion       31 int,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。