Edit

Share via

ITMultiTrackTerminal::get_TrackTerminals method (tapi3if.h)

  • Article

The get_TrackTerminals method creates and returns a collection containing the terminals contained by the multitrack terminal on which this method was called. The variant returned contains a pointer to an ITCollection interface that can be used to iterate through elements of type IEnumVARIANT. The elements of the collection contain pointers to tracks.

Syntax

HRESULT get_TrackTerminals(
  [out] VARIANT *pVariant
);

Parameters

[out] pVariant

Pointer to a VARIANT containing an ITCollection of ITTerminal interface pointers for the tracks available.

Return value

This method can return one of these values.

Value Meaning
S_OK
 Method succeeded.
E_POINTER
 The pVariant parameter is not a valid pointer.
E_OUTOFMEMORY
 Insufficient memory exists to perform the operation.
E_UNEXPECTED
 The pVariant parameter was not empty.

Remarks

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

Requirements

Requirement Value
Target Platform Windows
Header tapi3if.h (include Tapi3.h)
Library Uuid.lib
DLL Tapi3.dll

See also

ITCollection

ITMultiTrackTerminal

ITTerminal