ITSubStream::get_Terminals メソッド (tapi3if.h)

[アーティクル]
03/02/2024

get_Terminals メソッドは、現在のサブストリームに関連付けられているターミナルのコレクションを作成します。 Visual Basic で記述されたものなど、Automation クライアントアプリケーション用に提供されます。 C および C++ アプリケーションでは、 EnumerateTerminals メソッドを使用する必要があります。

構文

HRESULT get_Terminals(
  [out] VARIANT *pTerminals
);

パラメーター

[out] pTerminals

ITTerminal インターフェイスポインター (ターミナルオブジェクト) の ITCollection を含む VARIANT へのポインター。

戻り値

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

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

注釈

このメソッドは、サブストリームで選択されているターミナルのみを返します。ストリームまたはストリーム内の他のサブストリームで、他のターミナルを選択できます。これらのターミナルは返されません。

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