ITAddressTranslationInfo
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
アドレス変換データを判別するために使用します。
メソッド 5
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
get_DialableString メソッドは、ダイヤル可能な番号を含む文字列を取得します。通常、この番号はその後 ITAddress::CreateCall の pDestAddress 引数として使用されます。
| ppDialableString | LPWSTR* | out | ダイヤル可能な文字列の表現を格納した BSTR へのポインター。 |
戻り値
このメソッドは、次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| ppDialableString パラメーターが有効なポインターではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
解説(Remarks)
アプリケーションは、ppDialableString パラメーターに割り当てられたメモリを解放するために SysFreeString を使用する必要があります。
TAPI 2 の LINETRANSLATEOUTPUT 構造体の dwDialableStringSize メンバーおよび dwDialableStringOffset メンバーに対応します。
get_DisplayableString メソッドは、ダイヤル可能な番号の表示用バージョンを含む文字列を取得します。
| ppDisplayableString | LPWSTR* | out | 表示可能な文字列の表現を格納した BSTR へのポインター。 |
戻り値
このメソッドは、次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| ppDisplayableString パラメーターが有効なポインターではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
解説(Remarks)
アプリケーションは、ppDisplayableString パラメーターに割り当てられたメモリを解放するために SysFreeString を使用する必要があります。
TAPI 2 の LINETRANSLATEOUTPUT 構造体の dwDisplayableStringSize メンバーおよび dwDisplayableStringOffset メンバーに対応します。
get_CurrentCountryCode メソッドは、現在の国/地域コードを取得します。
| CountryCode | INT* | out | 国/地域コードへのポインター。 |
戻り値
このメソッドは、次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| CountryCode パラメーターが有効なポインターではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
解説(Remarks)
TAPI 2 の LINETRANSLATEOUTPUT 構造体の dwCurrentCountry メンバーに対応します。
通話先の国/地域コードを取得します。
| CountryCode | INT* | out | 宛先の国/地域コードへのポインター。 |
戻り値
このメソッドは、次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| CountryCode パラメーターが無効なポインターです。 | |
| 操作を実行するのに十分なメモリがありません。 |
解説(Remarks)
TAPI 2 の LINETRANSLATEOUTPUT 構造体の dwDestCountry メンバーに対応します。
get_TranslationResults メソッドは、変換操作の結果を取得します。
| plResults | INT* | out | 変換処理から得られた情報を示します。この情報は、アプリケーションがユーザーインターフェイス要素を表示する際に役立つ場合があります。この値は LINETRANSLATERESULT_ 定数のいずれかを使用します。 |
戻り値
このメソッドは、次のいずれかの値を返すことがあります。
| Return code | Description |
|---|---|
| メソッドが成功しました。 | |
| plResults パラメーターが有効なポインターではありません。 | |
| 操作を実行するのに十分なメモリがありません。 |
解説(Remarks)
TAPI 2 の LINETRANSLATEOUTPUT 構造体の dwTranslateResults メンバーに対応します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ITAddressTranslationInfo "{AFC15945-8D40-11D1-A09E-00805FC147D3}" #usecom global ITAddressTranslationInfo IID_ITAddressTranslationInfo "{}" #comfunc global ITAddressTranslationInfo_get_DialableString 7 var #comfunc global ITAddressTranslationInfo_get_DisplayableString 8 var #comfunc global ITAddressTranslationInfo_get_CurrentCountryCode 9 var #comfunc global ITAddressTranslationInfo_get_DestinationCountryCode 10 var #comfunc global ITAddressTranslationInfo_get_TranslationResults 11 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITAddressTranslationInfo "{AFC15945-8D40-11D1-A09E-00805FC147D3}" #usecom global ITAddressTranslationInfo IID_ITAddressTranslationInfo "{}" #comfunc global ITAddressTranslationInfo_get_DialableString 7 sptr #comfunc global ITAddressTranslationInfo_get_DisplayableString 8 sptr #comfunc global ITAddressTranslationInfo_get_CurrentCountryCode 9 sptr #comfunc global ITAddressTranslationInfo_get_DestinationCountryCode 10 sptr #comfunc global ITAddressTranslationInfo_get_TranslationResults 11 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。