Método ITTerminalSupport::CreateTerminal (tapi3if.h)

Artículo
03/08/2023

El método CreateTerminal crea e inicializa un nuevo objeto ITTerminal basado en la clase y los medios de terminal dinámicos. La clase terminal se identifica mediante un GUID. El GUID se debe convertir en una cadena mediante StringFromIID para pasar a este método.

Sintaxis

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

Parámetros

[in] pTerminalClass

Puntero a BSTR que contiene la clase de terminal (GUID) para el nuevo objeto de terminal.

[in] lMediaType

Puntero al tipo de medio para el nuevo objeto terminal.

[in] Direction

TERMINAL_DIRECTION descriptor de la dirección del terminal.

[out] ppTerminal

Puntero al objeto ITTerminal creado.

Valor devuelto

Este método puede devolver uno de estos valores.

Value	Significado
S_OK	El método se realizó correctamente.
E_INVALIDARG	El parámetro pTerminalClass o lMediaType no es válido.
E_POINTER	El parámetro ppTerminal no es un puntero válido.
E_OUTOFMEMORY	Existe memoria insuficiente para crear el objeto ITTerminal .
E_MEDIATYPE	El parámetro lMediaType no es válido.
TAPI_E_NOTSUPPORTED	No se admite la creación de terminales dinámicos.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pTerminalClass y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

Una vez creado un terminal, solo se puede seleccionar en una llamada.

TAPI llama al método AddRef en la interfaz ITTerminal devuelta por ITTerminalSupport::CreateTerminal. La aplicación debe llamar a Release en la interfaz ITTerminal para liberar recursos asociados a él.