ITAddress2::EnumeratePhones メソッド (tapi3if.h)
EnumeratePhones メソッドは、このアドレスで使用できる電話デバイスに対応する電話オブジェクトを列挙します。
このメソッドは、C/C++ アプリケーションを対象としています。 Visual Basic およびスクリプト アプリケーションでは 、get_Phones メソッドを使用する必要があります。
構文
HRESULT EnumeratePhones(
[out] IEnumPhone **ppEnumPhone
);
パラメーター
[out] ppEnumPhone
新しい IEnumPhone インターフェイスへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
値 | 意味 |
---|---|
|
メソッドが成功しました。 |
|
ppEnumPhone パラメーターが有効なポインターではありません。 |
|
操作を実行するためのメモリが不足しています。 |
|
不明な理由でメソッドが失敗しました。 |
注釈
電話デバイスは、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 |