DMessengerEvents::OnContactStatusChange Event
Deprecated. Indicates that the status of a contact in the local client's Contact List has changed, and returns the current state of the contact.
Syntax
void OnContactStatusChange( IDispatch *pMContact, MISTATUS mStatus );
Parameters
- pMContact
[in] Pointer to a IDispatch interface on the MessengerContact object that corresponds to the contact. Using this pointer, clients can now code to its IMessengerContact interface. There is no hr in this event. Unless there is an error, pMContact will not be NULL.- mStatus
[in] A member of the MISTATUS enumerator that specifies the current state of the MessengerContact object.
Return Value
No return value.
Event DISPID
DISPID_MUAE_ONUSERSTATECHANGE
The DISPID for this event is defined in msgrua.h. Use this value to identify the event handler when implementing IDispatch::Invoke.
Remarks
When the local client initially signs in to the service, events are distributed for those users on the local client's Contact List who are not offline. Otherwise, such events are distributed whenever status changes.
This event is received only for users in the client's Contact List.
All online MISTATUS results are grouped by a common factor in the constant.
To be used when writing custom ::Invoke methods to handle these events.
Parameter vaArgs[x] Variant Type mStatus 0 VT_14 pMContact 1 VT_DISPATCH Note This event is available for scripting languages.
Important DMessengerEvents::OnContactStatusChange is no longer available in Windows Vista. See Windows Messenger for more information.
See Also
IMessengerContact::Status, DMessengerEvents::OnMyStatusChange