ITSubStream::UnselectTerminal method (tapi3if.h)

Article
02/22/2024

The UnselectTerminal method unselects the terminal from the substream.

Syntax

HRESULT UnselectTerminal(
  [in] ITTerminal *pTerminal
);

Parameters

[in] pTerminal

Pointer to ITTerminal interface terminal to remove from stream.

Return value

This method can return one of these values.

Value	Meaning
S_OK	Method succeeded.
E_POINTER	The pTerminal parameter is not a valid pointer.
E_OUTOFMEMORY	Insufficient memory exists to perform the operation.
TAPI_E_INVALIDTERMINAL	The pTerminal parameter does not point to a valid terminal.
TAPI_E_NOTSUPPORTED	The provider does not support this operation.

Remarks

Some stream events may be received after streaming has been stopped due to delayed transmission.

Successfully unselecting the last terminal from a substream effectively ceases any existing streaming for this particular substream. Subsequently selecting the same terminal or another terminal restarts such interrupted streaming.

Requirements

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