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

  • [アーティクル]

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

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

構文

HRESULT get_Addresses(
  [out] VARIANT *pAddresses
);

パラメーター

[out] pAddresses

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

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

電話デバイスは、PHONECAPS 構造体の dwPhoneFeatures メンバーのPHONEFEATURE_GENERICPHONE ビットを設定することで、TSP によってオーディオターミナルをサポートするすべてのアドレスで使用可能であると宣言します。 電話デバイスは、デバイス クラス tapi/line で phoneGetID を使用してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに優先されると宣言することもできます。 get_Addresses メソッドは、両方の方法で識別されたアドレスを返します。

電話が優先されるアドレスのみを取得するには、 get_PreferredAddresses メソッドを呼び出します。

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

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

要件

要件 値
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)
Library Uuid.lib
[DLL] Tapi3.dll

こちらもご覧ください

ITPhone

get_PreferredAddresses