DMessengerEvents::OnContactRemovedFromGroup Event

  • Article

Deprecated. Indicates that a contact has been removed from a group.

Syntax

void OnContactRemovedFromGroup(      
    LONG hr,
    IDispatch *pMGroup,
    VARIANT_BOOL pMContact
);

Parameters

  • hr
    [in] Success or error code as a LONG. Possible values are as follows:
    • S_OK
      A user was successfully removed from the group.
    • MSGR_E_USER_NOT_FOUND
      The user specified to be removed does not exist.
    • MSGR_E_USER_NOT_GROUP_MEMBER
      The user specified to be removed does not belong to the group.
    • MSGR_E_GROUP_DOES_NOT_EXIST
      The group specified could not be found.
  • 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.
  • pMContact
    [in] Pointer to a IDispatch interface on the MessengerContact object that corresponds to the group from which the contact was removed. Using this pointer, clients can now code to its IMessengerContact interface.

Return Value

No return value.

Event DISPID

DISPID_MUAE_REMOVE_USRGRP

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
pMContact 0 VT_DISPATCH
pMGroup 1 VT_DISPATCH
hr 2 VT_I4

Note  This event is available for scripting languages.

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