Share via


IRTCClientPresence2::EnumerateGroups

The EnumerateGroups method returns an enumeration of the groups available on this client. If there are no groups on this client, an empty enumeration is returned. This method is intended for C and C++ applications. Visual Basic applications should use the get_Groups method.

HRESULT EnumerateGroups(IRTCEnumGroups**ppEnum);

Parameters

  • ppEnum
    Pointer to the IRTCEnumGroups interface on an enumeration object containing an IRTCBuddyGroup pointer for each group on this client. 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.

Value Meaning
RTC_E_PRESENCE_NOT_ENABLED Presence has not been enabled.
E_FAIL There are no groups.
E_OUTOFMEMORY Insufficient memory to perform this operation.
E_POINTER The ppEnum parameter is not a valid pointer.

Requirements

Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClientPresence2 is defined as AD1809E8-62F7-4783-909A-29C9D2CB1D34.

See Also

IRTCClientPresence2, IRTCClientPresence, IRTCClientPresence2::get_Groups, IRTCClientPresence2::get_Group