DMessengerEvents::OnContactPropertyChange event

Article
05/31/2018

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

Indicates that property information for a contact in the local client's Contact List has changed.

Syntax

void OnContactPropertyChange(
  [in] LONG             hr,
  [in] IDispatch        *pContact,
  [in] MCONTACTPROPERTY ePropType,
  [in] VARIANT          vPropVal
);

Parameters

hr [in]

Success or error code as a LONG.

An error result for hr might result in all other event parameters being meaningless, NULL, or otherwise invalid. Always check for a successful hr before attempting to use the other event parameters.

pContact [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.

A MessengerContact object that corresponds to the contact.

ePropType [in]

A value in the MCONTACTPROPERTY enumeration.

*vPropVal* \[in\]


C++	A VARIANT intended to transmit the value of future properties. Type checking will depend on the property, but should only be assumed to be a VARIANT. Clients should check the VT_ value of the results and perform coercions, if desired.
VB	A VARIANT intended to transmit the value of future properties. Type checking will depend on the property, but should only be assumed to be a VARIANT.

Return value

This event does not return a value.

Remarks

This event exists for later expansions of properties that can be associated with a contact but that will not require another iteration of the Windows Messenger interfaces. The current properties (CanPage, Phone, FriendlyName, Blocked) have their own get_ methods and specific change events. By the current definition of the MCONTACTPROPERTY enumeration, there are no additional properties.

To be used when writing custom ::Invoke methods to handle these events.

Parameter	vaArgs[x]	Variant Type
vPropVal	0	(Unknown VARIANT)
ePropType	1	VT_I4
pContact	2	VT_DISPATCH
hr	3	VT_I4

Note

This event is not 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