ITAddress2::get_Phones メソッド (tapi3if.h)
get_Phones メソッドは、このアドレスで使用できる電話デバイスに対応する電話オブジェクトの ITCollection への VARIANT ポインターを返します。
このメソッドは、Visual Basic およびスクリプト アプリケーションを対象としています。 C/C++ アプリケーションでは、代わりに EnumeratePhones メソッドを使用する 必要があります。
構文
HRESULT get_Phones(
[out] VARIANT *pPhones
);
パラメーター
[out] pPhones
ITPhone インターフェイス ポインターの ITCollection を含む VARIANT へのポインター。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
電話デバイスは、PHONECAPS 構造体の dwPhoneFeatures メンバーのPHONEFEATURE_GENERICPHONE ビットを設定することで、TSP によってオーディオターミナルをサポートするすべてのアドレスで使用可能であると宣言します。 電話デバイスは、デバイス クラス tapi/line を使用して phoneGetID を介してアドレス/回線 ID を返すことによって、アドレスまたはアドレスのセットに優先されると宣言することもできます。 アドレスで使用できる電話がない場合、このメソッドは空のコレクションを生成し、S_OKを返します。
TAPI は、ITAddress2::get_Phones によって返される ITPhone インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITPhone インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |
| Library | Uuid.lib |
| [DLL] | Tapi3.dll |