IRTCSession::EnumerateParticipants

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This method retrieves an enumeration of the participants in this session, excluding the local user. If there are no participants in the session, an empty enumeration is retrieved. This method is intended for C and C++ applications.

Syntax

HRESULT EnumerateParticipants(
  IRTCEnumParticipants** ppEnum
);

Parameters

• ppEnum
  [out] Pointer to the IRTCEnumParticipants interface on an enumeration object containing an IRTCParticipant pointer for each participant in the session.

  This method adds a reference to the enumeration object, which the caller is responsible for releasing.

Return Value

This method can return an RTC_E_ constant.

Remarks

The online status of participants in a multiparty instant messaging (MIM) session is available to all other participants in the session. This can result in compromised privacy information.

If none of the participants in the session has blocked another participant from viewing its online status, no privacy information is compromised. However, if a participant in the session has blocked another participant from viewing its online status, the first participant's privacy information is compromised in a MIM session.

Requirements

See Also

Reference

IRTCSession
IRTCEnumParticipants
IRTCParticipant
IRTCSession::Participants