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