DMessengerEvents::OnContactAddedToGroup event
[OnContactAddedToGroup is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Indicates that a contact has been added to a group.
Syntax
void OnContactAddedToGroup(
[in] LONG hr,
[in] IDispatch *pMGroup,
[in] IDispatch *pMContact
);
Parameters
-
hr [in]
-
Success or error code as a LONG. For a table of the MSGR_E_* constants, see MSGRConstants.
Possible values are as follows:
Value Meaning - S_OK
A user was successfully blocked or unblocked. - MSGR_E_USER_NOT_FOUND
The user specified to be added does not exist. - 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 indicating the group to which the contact was added. Using this pointer, clients can now code to its IMessengerGroup interface. VB A MessengerGroup object corresponding to the group to which the contact was added. - *pMContact* \[in\]
-
C++ Pointer to a IDispatch interface on the MessengerContact object indicating the added contact. Using this pointer, clients can now code to its IMessengerContact interface. VB A MessengerContact object corresponding to the added contact.
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 |
|
| IDL |
|
| DLL |
|