ITTerminalSupport：：CreateTerminal 方法 (tapi3if.h)

發行項
08/26/2023

CreateTerminal方法會根據動態終端機類別和媒體，建立並初始化新的ITTerminal物件。終端機類別是由 GUID 識別。 GUID 必須使用 StringFromIID 轉換成字串，才能傳遞至這個方法。

語法

HRESULT CreateTerminal(
  [in]  BSTR               pTerminalClass,
  [in]  long               lMediaType,
  [in]  TERMINAL_DIRECTION Direction,
  [out] ITTerminal         **ppTerminal
);

參數

[in] pTerminalClass

包含新終端物件之GUID (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	不支援動態終端機建立。