次の方法で共有


ITAddress2::EnumeratePhones メソッド (tapi3if.h)

EnumeratePhones メソッドは、このアドレスで使用できる電話デバイスに対応する電話オブジェクトを列挙します。

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

構文

HRESULT EnumeratePhones(
  [out] IEnumPhone **ppEnumPhone
);

パラメーター

[out] ppEnumPhone

新しい IEnumPhone インターフェイスへのポインター。

戻り値

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

意味
S_OK
メソッドが成功しました。
E_POINTER
ppEnumPhone パラメーターが有効なポインターではありません。
E_OUTOFMEMORY
操作を実行するためのメモリが不足しています。
E_UNEXPECTED
不明な理由でメソッドが失敗しました。

注釈

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

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

要件

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

こちらもご覧ください

IEnumPhone

ITAddress2