DMessengerEvents::OnGroupAdded Event

  • Article

Deprecated.  Indicates that a new group has been created.

Syntax

void OnGroupAdded(      
    LONG hr,
    IDispatch *pMGroup
);

Parameters

  • hr
    [in] Success or error code as a LONG. Possible values are as follows:
    • 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] Pointer to a IDispatch World Wide Web link 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.

Return Value

No return value.

Event DISPID

DISPID_MUAE_ADDGROUP

The DISPID for this event is defined in msgrua.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

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

Important  DMessengerEvents::OnGroupAdded is no longer available in Windows Vista. See Windows Messenger for more information.

Note  This event is available for scripting languages.

See Also

IMessenger2::CreateGroup