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
);

Parameters

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.

Return value

This event does not return a value.

Remarks

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.

Requirements

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

See also

DMessengerEvents

CreateGroup