IRTCSession::EnumerateParticipants

  • Article

The EnumerateParticipants method returns an enumeration of the participants in this session, excluding the local user. If there are no participants in the session, an empty enumeration is returned. This method is intended for C and C++ applications. Visual Basic applications should use the get_Participants method.

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 call adds a reference to the enumeration object, which the caller is responsible for releasing.

Return Values

RTC methods may return an RTC_E_ constant.

Remarks

Note  The online status of participants in a MIM session will be available to all other participants in the session. This may result in compromised privacy information. If none of the participants in the session has blocked another participant from viewing his online status, no privacy information would be compromised. However, if any participant in the session has blocked another participant from viewing his online status, the first participant's privacy information would be compromised in a MIM session.

Requirements

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCSession is defined as 387c8086-99be-42fb-9973-7c0fc0ca9fa8.

See Also

IRTCSession, IRTCSession::get_Participants, IRTCEnumParticipants, IRTCParticipant