DMessengerEvents::OnContactStatusChange event

Article
05/31/2018

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

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(
  [in] IDispatch *pMContact,
  [in] MISTATUS  mStatus
);

Parameters

*pMContact* \[in\]


C++	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.
VB	A MessengerContact object that corresponds to the contact. 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

This event does not return a value.

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.

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

Share via