ITAddressTranslation::get_Locations メソッド (tapi3if.h)
get_Locations メソッドは、現在使用可能なアドレスの場所のコレクションを作成します。 このメソッドは、Visual Basic で記述されたものなど、Automation クライアント アプリケーションに対して提供されます。 C および C++ アプリケーションでは、 EnumerateLocations メソッドを使用する必要があります。
構文
HRESULT get_Locations(
[out] VARIANT *pVariant
);
パラメーター
[out] pVariant
ITLocationInfo インターフェイス ポインター (location オブジェクト) の ITCollection を含む VARIANT へのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
pVariant パラメーターは有効なポインターではありません。 |
|
操作を実行するためのメモリが不足しています。 |
解説
get_Locations メソッドは TAPI 2.1 LineGetTranslateCaps 関数の COM ラッパーであり、その関数によって返される LINETRANSLATECAPS 構造体から位置情報を取得します。
TAPI は、ITAddressTranslation::get_Locations によって返される ITLocationInfo インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITLocationInfo インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。
必要条件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |
| Library | Uuid.lib |
| [DLL] | Tapi3.dll |