DMessengerEvents::OnContactPropertyChange event

[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

See also

DMessengerEvents

Property

OnContactPhoneChange

OnContactPagerChange

OnContactFriendlyNameChange

OnContactBlockChange