ITPhone::get_Terminals メソッド (tapi3if.h)
get_Terminals メソッドは、電話に関連付けられているターミナルのコレクションを取得します。 このメソッドを実行する前に、アプリケーションで ITPhone::Open を呼び出す必要はありません。
構文
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
パラメーター
[in] pAddress
ITAddress インターフェイスへのポインター。
[out] pTerminals
ITTerminal インターフェイス ポインターの ITCollection を含む VARIANT へのポインター。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
解説
電話に関連付けられているターミナルがない場合、このメソッドは空のコレクションを生成し、S_OKを返します。
アプリケーションは、get_Terminalsを呼び出す前に ITPhone::Open メソッドを呼び出す必要はありません。 これは、電話オブジェクトの実装が電話を開き、TAPI 初期化中または新しい電話オブジェクトが表示されたときに phoneGetID を呼び出すことができるためです。
TAPI は、ITPhone::get_Terminals によって返される ITAddress インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITAddress インターフェイスで Release を呼び出して、関連付けられているリソースを解放する必要があります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |
| Library | Uuid.lib |
| [DLL] | Tapi3.dll |