Share via


DMessengerEvents::OnGroupNameChanged event

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

Indicates that the name of a group has been changed.

Syntax

void OnGroupNameChanged(
  [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 name was successfully changed.
MSGR_E_GROUP_NAME_TOO_LONG
The name of the group to be changed is too long.
MSGR_E_BAD_GROUP_NAME
The name of the group to be changed is invalid.
*pMGroup* \[in\]
C++ Pointer to a IDispatch interface on the MessengerGroup object that corresponds to the group from wich 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

The OnGroupNameChanged event is scriptable.

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