IRTCClientPresence2::EnumerateGroups (Windows Embedded CE 6.0)

1/6/2010

Note

This method is unsupported in Windows Embedded CE 6.0.

This method retrieves an enumeration of the groups available on this client.

If there are no groups on the client, the method retrieves an empty enumeration.

This method is intended for C and C++ applications.

Syntax

HRESULT EnumerateGroups( 
  IRTCEnumGroups** ppEnum 
);

ppEnum
Pointer to the IRTCEnumGroups interface on an enumeration object containing an IRTCBuddyGroup pointer for each group on this client.

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

This method can return an RTC_E_ constant.

The following table shows additional possible return values.

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