ITPhone::get_PreferredAddresses メソッド (tapi3if.h)

[アーティクル]
03/02/2024

get_PreferredAddresses メソッドは、電話が使用するために推奨されるアドレスのコレクションを返します。このメソッドを実行する前に、アプリケーションで ITPhone::Open を呼び出す必要はありません。

このメソッドは、Visual Basic およびスクリプトアプリケーションを対象としています。 C/C++ アプリケーションでは、 EnumerateAddresses メソッドを使用する方が便利です。

構文

HRESULT get_PreferredAddresses(
  [out] VARIANT *pAddresses
);

パラメーター

[out] pAddresses

ITAddress インターフェイスポインターの ITCollection を含む VARIANT へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	意味
S_OK	メソッドが成功しました。
E_POINTER	pAddresses パラメーターは有効なポインターではありません。
E_OUTOFMEMORY	コレクションオブジェクトを割り当てるのに十分なメモリがありません。

注釈

システムに使用可能なアドレスが存在しない場合、このメソッドは空のコレクションを返します。

電話デバイスは、デバイスクラス tapi/line で TAPI 2.x phoneGetID 関数を使用してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに優先されると宣言します。

phoneGetID 関数には、開いている電話デバイスへのハンドルが必要ですが、アプリケーションは EnumeratePreferredAddresses を呼び出す前に ITPhone::Open メソッドを呼び出す必要はありません。これは、電話オブジェクトの実装が電話を開き、TAPI 初期化中または新しい電話オブジェクトが表示されたときに phoneGetID を呼び出すことができるためです。

TAPI は、ITPhone::get_PreferredAddresses によって返される ITAddress インターフェイスで AddRef メソッドを呼び出します。アプリケーションは、ITAddress インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。