ITTerminalSupport::CreateTerminal メソッド (tapi3if.h)
CreateTerminal メソッドは、動的ターミナル クラスとメディアに基づいて、新しい ITTerminal オブジェクトを作成および初期化します。 ターミナル クラスは GUID によって識別されます。 このメソッドに渡すには、 StringFromIID を 使用して GUID を文字列に変換する必要があります。
構文
HRESULT CreateTerminal(
[in] BSTR pTerminalClass,
[in] long lMediaType,
[in] TERMINAL_DIRECTION Direction,
[out] ITTerminal **ppTerminal
);
パラメーター
[in] pTerminalClass
新しいターミナル オブジェクトのターミナル クラス (GUID) を含む BSTR へのポインター。
[in] lMediaType
新しいターミナル オブジェクトの メディアの種類 へのポインター。
[in] Direction
ターミナル 方向の記述子をTERMINAL_DIRECTIONします。
[out] ppTerminal
作成された ITTerminal オブジェクトへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
pTerminalClass パラメーターまたは lMediaType パラメーターが無効です。 |
|
ppTerminal パラメーターは有効なポインターではありません。 |
|
ITTerminal オブジェクトを作成するためのメモリが不足しています。 |
|
lMediaType パラメーターが無効です。 |
|
動的ターミナルの作成はサポートされていません。 |
解説
アプリケーションでは 、SysAllocString を使用して pTerminalClass パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。
ターミナルが作成されると、1 つの呼び出しにのみ選択できます。
TAPI は、ITTerminalSupport::CreateTerminal によって返される ITTerminal インターフェイスで AddRef メソッドを呼び出します。 アプリケーションは、ITTerminal インターフェイスで Release を呼び出して、それに関連付けられているリソースを解放する必要があります。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |