ITTerminalSupport2::get_PluggableTerminalClasses method (tapi3if.h)

Article
02/22/2024

The get_PluggableTerminalClasses method returns a collection of ITPluggableTerminalClassInfo terminal class information interface pointers.

This method is intended for Visual Basic and scripting applications. C/C++ applications can use the EnumeratePluggableTerminalClasses method.

Syntax

HRESULT get_PluggableTerminalClasses(
  [in]  BSTR    bstrTerminalSuperclass,
  [in]  long    lMediaType,
  [out] VARIANT *pVariant
);

Parameters

[in] bstrTerminalSuperclass

The BSTR representation of the CLSID for the terminal superclass.

[in] lMediaType

Bitwise ORed list of media types supported by the terminal classes.

[out] pVariant

Pointer to a VARIANT containing an ITCollection of ITPluggableTerminalClassInfo interface pointers.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_INVALIDARG	The lMediaType parameter is not valid.
E_FAIL	The method failed.
E_POINTER	The bstrTerminalSuperclass or pVariant parameter is not a valid pointer.

Remarks

TAPI calls the AddRef method on the ITPluggableTerminalClassInfo interface returned by ITTerminalSupport2::get_PluggableTerminalClasses. The application must call Release on the ITPluggableTerminalClassInfo interface to free resources associated with it.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)