ITAddressTranslation

ITAddressTranslation インターフェイスは、発信先アドレスを別の形式に変換するためのメソッドを提供します。たとえば、アプリケーションはコール(通話)を発信する前に、アドレスを正規形式からダイヤル可能な形式に変換する必要がある場合があります。

TranslateAddress メソッドは、アドレス変換情報インターフェイスを作成します。

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

アプリケーションは、pAddressToTranslate のメモリを確保するために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

TranslateAddress メソッドは、TAPI 2.1 の LineTranslateAddress 関数の COM ラッパーです。

TAPI は、TranslateAddress が返す ITAddressTranslationInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITAddressTranslationInfo インターフェイスの Release を呼び出す必要があります。

TranslateDialog メソッドは、アプリケーションモーダルのダイアログボックスを表示します。このダイアログボックスでは、これからダイヤルしようとする電話番号の現在のロケーションを変更したり、ロケーションやコーリングカードのパラメーターを調整したり、その結果を確認したりできます。

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

アプリケーションは、pAddressIn のメモリを確保するために SysAllocString を使用し、変数が不要になったときにメモリを解放するために SysFreeString を使用する必要があります。

TranslateDialog メソッドは、TAPI 2.1 の LineTranslateDialog 関数の COM ラッパーです。

EnumerateLocations メソッドは、現在利用可能なアドレスのロケーションを列挙します。このメソッドは C および C++ アプリケーション向けに提供されています。Visual Basic で記述されたものなどのオートメーションクライアントアプリケーションは、get_Locations メソッドを使用する必要があります。

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

EnumerateLocations メソッドは、TAPI 2.1 の LineGetTranslateCaps 関数の COM ラッパーであり、その関数が返す LINETRANSLATECAPS 構造体からロケーション情報を取得します。

TAPI は、ITAddressTranslation::EnumerateLocations が返す IEnumLocation インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IEnumLocation インターフェイスの Release を呼び出す必要があります。

get_Locations メソッドは、現在利用可能なアドレスのロケーションのコレクションを作成します。このメソッドは、Visual Basic で記述されたものなどのオートメーションクライアントアプリケーション向けに提供されています。C および C++ アプリケーションは、EnumerateLocations メソッドを使用する必要があります。

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

get_Locations メソッドは、TAPI 2.1 の LineGetTranslateCaps 関数の COM ラッパーであり、その関数が返す LINETRANSLATECAPS 構造体からロケーション情報を取得します。

TAPI は、ITAddressTranslation::get_Locations が返す ITLocationInfo インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITLocationInfo インターフェイスの Release を呼び出す必要があります。

EnumerateCallingCards メソッドは、アドレスに関連付けられたコーリングカードを列挙します。このメソッドは C および C++ アプリケーション向けに提供されています。Visual Basic で記述されたものなどのオートメーションクライアントアプリケーションは、get_CallingCards メソッドを使用する必要があります。

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

このメソッドは、TAPI 2.1 の LineGetTranslateCaps 関数の COM ラッパーであり、その関数が返す LINETRANSLATECAPS 構造体からコーリングカード情報を取得します。

TAPI は、ITAddressTranslation::EnumerateCallingCards が返す IEnumCallingCard インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために IEnumCallingCard インターフェイスの Release を呼び出す必要があります。

get_CallingCards メソッドは、アドレスに関連付けられたコーリングカードのコレクションを作成します。

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

get_CallingCards メソッドは、TAPI 2.2 の LineGetTranslateCaps 関数の COM ラッパーであり、その関数が返す LINETRANSLATECAPS 構造体からコーリングカード情報を取得します。

TAPI は、ITAddressTranslation::get_CallingCards が返す ITCallingCard インターフェイスに対して AddRef メソッドを呼び出します。アプリケーションは、それに関連付けられたリソースを解放するために ITCallingCard インターフェイスの Release を呼び出す必要があります。