Share via

IRTCSession::RemoveParticipant

  • Article

This method removes a participant from the session. It is applicable only for outgoing phone-to-phone calls and will fail for all other types of calls.

HRESULT RemoveParticipant(
  IRTCParticipant* pParticipant
);

Parameters

  • pParticipant
    [in] Pointer to an IRTCParticipant interface on the Participant object to remove from the session.

Return Values

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

Value Description
E_FAIL The participant cannot be removed from this session.

Remarks

Removing the last participant in the session will terminate the session. Calling the IRTCParticipant::Removable method on the participant will allow the UI to determine if it is possible to remove this participant from the session.

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

IRTCParticipant::Removable | IRTCSession::AddParticipant

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.