DMessengerEvents::OnGroupAdded event

[OnGroupAdded is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

Indicates that a new group has been created.

Syntax

void OnGroupAdded(
  [in] LONG      hr,
  [in] IDispatch *pMGroup
);

hr [in]

Success or error code as a LONG. Possible values are as follows:

Value	Meaning
S_OK	A group was successfully added.
MSGR_E_GROUP_ALREDY_EXISTS	The name of the group to be added already exists.
MSGR_E_GROUP_NAME_TOO_LONG	The name of the group to be added is too long.
MSGR_E_BAD_GROUP_NAME	The name of the group to be added is invalid.

*pMGroup* \[in\]


C++	Pointer to a IDispatch interface on the MessengerGroup object that corresponds to the group from which the contact was removed. Using this pointer, clients can now code to its IMessengerGroup interface.
VB	A MessengerGroup object that corresponds to the group from wich the contact was removed.

This event does not return a value.

To be used when writing custom ::Invoke methods to handle these events.

Parameter	vaArgs[x]	Variant Type
pMGroup	0	VT_DISPATCH
hr	1	VT_I4

Note

This event is available for scripting languages.


Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Product	Messenger 4.5
Header	Msgrua.h
IDL	Msgrua.idl
DLL	Msgsc.dll