Share via


DMessengerEvents::OnContactRemovedFromGroup event

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

Indicates that a contact has been removed from a group.

Syntax

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

Parameters

hr [in]

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

Value Meaning
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\]
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 which the contact was removed.
*pMContact* \[in\]
C++ 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.
VB A MessengerContact object that corresponds to the group from which 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
pMContact 0 VT_DISPATCH
pMGroup 1 VT_DISPATCH
hr 2 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