IMessenger2::MyGroups property
[MyGroups is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Retrieves the Group list contained in the Messenger object. The retrieved list is a MessengerGroups collection object that can be manipulated with the IMessengerGroups interface.
This property is read-only.
Syntax
HRESULT get_MyGroups(
[out, retval] IDispatch **ppMGroups
);
Property value
Return value. Pointer to a pointer to an IDispatch interface. In practice, this returns the IMessengerGroups interface on the Contact List or MessengerGroups collection object.
Error codes
Returns one of the following values.
| Name | Meaning |
|---|---|
|
Success. |
|
Error during list creation. |
|
ppMGroups is a NULL pointer. |
|
The current service does not support groups. |
Remarks
Some services, such as Microsoft Exchange Instant Messaging Service (IM), do not support groups. The use of this property on these services will return the error MSGR_E_GROUPS_NOT_ENABLED.
ppMGroups should be released when it is no longer needed. Retrieved lists can potentially have zero members in their collection.
If this property is called while the client is not signed in, the HRESULT will be S_OK and a true object will be returned. However, the resulting MessengerGroups collection object will have zero members (that is, it contains no valid MessengerGroups objects).
Note
This property is available for scripting languages.
Requirements
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Header |
|
| IDL |
|
| DLL |
|