次の方法で共有

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 オブジェクトへのポインター。

戻り値

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

値 説明
S_OK
 メソッドが成功しました。
E_INVALIDARG
 pTerminalClass パラメーターまたは lMediaType パラメーターが無効です。
E_POINTER
 ppTerminal パラメーターは有効なポインターではありません。
E_OUTOFMEMORY
 ITTerminal オブジェクトを作成するためのメモリが不足しています。
E_MEDIATYPE
 lMediaType パラメーターが無効です。
TAPI_E_NOTSUPPORTED
 動的ターミナルの作成はサポートされていません。

解説

アプリケーションでは 、SysAllocString を使用して pTerminalClass パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。

ターミナルが作成されると、1 つの呼び出しにのみ選択できます。

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

要件

   
対象プラットフォーム Windows
ヘッダー tapi3if.h (Tapi3.h を含む)

関連項目

Address オブジェクト

ITTerminalSupport

TERMINAL_DIRECTION

ターミナル オブジェクト

ターミナル オブジェクト インターフェイス

メディアの種類

ターミナル クラス