ITTerminalSupport::CreateTerminal method (tapi3if.h)

The CreateTerminal method creates and initializes a new ITTerminal object based on the dynamic terminal class and media. The terminal class is identified by a GUID. The GUID must be converted to a string using StringFromIID to pass to this method.

Syntax

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

Parameters

[in] pTerminalClass

Pointer to BSTR containing the terminal class (GUID) for the new terminal object.

[in] lMediaType

Pointer to the media type for the new terminal object.

[in] Direction

TERMINAL_DIRECTION descriptor of the terminal direction.

[out] ppTerminal

Pointer to the ITTerminal object created.

Return value

This method can return one of these values.

Remarks

The application must use SysAllocString to allocate memory for the pTerminalClass parameter and use SysFreeString to free the memory when the variable is no longer needed.

Once a terminal is created, it can be selected onto only one call.

TAPI calls the AddRef method on the ITTerminal interface returned by ITTerminalSupport::CreateTerminal. The application must call Release on the ITTerminal interface to free resources associated with it.

Requirements

See also

Address Object

ITTerminalSupport

TERMINAL_DIRECTION

Terminal Object

Terminal Object Interfaces

media type

terminal class