itTerminalSupport：：CreateTerminal 方法 (tapi3if.h)

项目
08/26/2023

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	不支持创建动态终端。