Share via

IRTCSession::RemoveStream

  • Article

This method removes one media stream from this session. The session must be in the RTCSS_CONNECTED or RTCSS_INPROGRESS state. The call will start a renegotiation with the other end of the call, and an RTCE_SESSION_STATE_CHANGE event will be triggered.

HRESULT RemoveStream(
  long lMediaType,
  LONG_PTR lCookie
);

Parameters

  • lMediaType
    [in] RTCMT_ constant specifying the media type for which to remove the stream. Only one stream can be removed by this call. Windows CE does not support RTCMT_VIDEO_SEND, RTCMT_VIDEO_RECEIVE and RTCMT_T120_SENDRECV media types.
  • lCookie
    [in] Pointer to an application-provided cookie used in the completion notification.

Return Values

This method can return an RTC_E_ constant. The following table shows the possible return values.

Value Description
RTC_E_INVALID_SESSION_STATE Session must be connected or in progress.
RTC_E_INVALID_SESSION_TYPE Session must be of type PC-to-PC or PC-to-phone.

Remarks

Security Note   This method can send data over the network in unencrypted form. Therefore, someone eavesdropping on the network might be able to read the data. Before using this method in an unencrypted session, consider the security risk of sending the data in clear text. The application can encrypt an RTC session by specifying TLS in the profile used for the session.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCSession::AddStream

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.