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

  • [アーティクル]

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

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

構文

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

パラメーター

[out] ppEnumAddress

IEnumAddress インターフェイスへのポインター。

戻り値

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

注釈

アドレスで使用できる電話がない場合、このメソッドは空の列挙を生成し、S_OKを返します。

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

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

電話デバイスは、デバイス クラス tapi/line で phoneGetID を使用してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに固有であると宣言します。 phoneGetID 関数には、開いている電話デバイスへのハンドルが必要ですが、アプリケーションは EnumerateAddresses を呼び出す前に ITPhone::Open メソッドを呼び出す必要はありません。 これは、電話オブジェクトの実装が電話を開き、TAPI 初期化中または新しい電話オブジェクトが表示されたときに phoneGetID を呼び出すことができるためです。

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

要件

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

こちらもご覧ください

EnumeratePreferredAddresses

ITPhone