IRTCClientPresence2::get_Groups
The get_Groups property gets a collection of the groups available on this client. If there are no groups on this client, an empty collection is returned. This method is intended for applications written in Visual Basic. C and C++ applications should use the IRTCClientPresence2::EnumerateGroups method.
HRESULT get_Groups(IRTCCollection**ppCollection);
Parameters
- ppCollection
[out] Pointer to the IRTCCollection interface on a collection object containing an IRTCBuddyGroup pointer for each watcher on this client. This call adds a reference to the collection object, which the caller is responsible for releasing.
Return Values
RTC methods may return an RTC_E_ constant.
Value | Meaning |
---|---|
RTC_E_NOT_EXIST | The groups do not exist. |
RTC_E_CLIENT_NOT_INITIALIZED | The client object is not initialized. |
RTC_E_PRESENCE_NOT_ENABLED | Presence has not been enabled. |
E_POINTER | The ppCollection 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_Group, IRTCClientPresence2::EnumerateGroups