Метод 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

Указатель на BSTR , содержащий класс терминала (GUID) для нового объекта терминала.

[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 для освобождения памяти, когда переменная больше не нужна.

После создания терминала его можно выбрать только для одного вызова.

TAPI вызывает метод AddRef в интерфейсе ITTerminal , возвращенном МЕТОДом ITTerminalSupport::CreateTerminal. Приложение должно вызвать Release в интерфейсе ITTerminal , чтобы освободить связанные с ним ресурсы.