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

Artigo
08/26/2023

O método CreateTerminal cria e inicializa um novo objeto ITTerminal com base na classe de terminal dinâmico e na mídia. A classe de terminal é identificada por um GUID. O GUID deve ser convertido em uma cadeia de caracteres usando StringFromIID para passar para esse método.

Sintaxe

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

Parâmetros

[in] pTerminalClass

Ponteiro para BSTR que contém a classe de terminal (GUID) para o novo objeto terminal.

[in] lMediaType

Ponteiro para o tipo de mídia do novo objeto de terminal.

[in] Direction

TERMINAL_DIRECTION descritor da direção do terminal.

[out] ppTerminal

Ponteiro para o objeto ITTerminal criado.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O parâmetro pTerminalClass ou lMediaType não é válido.
E_POINTER	O parâmetro ppTerminal não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para criar o objeto ITTerminal .
E_MEDIATYPE	O parâmetro lMediaType é inválido.
TAPI_E_NOTSUPPORTED	Não há suporte para a criação de terminal dinâmico.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pTerminalClass e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

Depois que um terminal é criado, ele pode ser selecionado em apenas uma chamada.

O TAPI chama o método AddRef na interface ITTerminal retornada por ITTerminalSupport::CreateTerminal. O aplicativo deve chamar Release na interface ITTerminal para liberar recursos associados a ele.