DMessengerEvents::OnContactPropertyChange Event

  • Article

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

Syntax

void OnContactPropertyChange(      
    LONG hr,
    IDispatch *pContact,
    MCONTACTPROPERTY ePropType,
    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 World Wide Web link interface on the MessengerContact object that corresponds to the contact. Using this pointer, clients can now code to its IMessengerContact interface.

  • ePropType
    [in] A value in the MCONTACTPROPERTY enumeration.

  • vPropVal
    [in] 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.

Return Value

No return value.

Event DISPID

DISPID_MUAE_ONUSERPROPERTYCHANGE

The DISPID for this event is defined in msgrua.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

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 Microsoft 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.

Important  DMessengerEvents::OnContactPropertyChange is no longer available in Windows Vista. See Windows Messenger for more information.

See Also

IMessengerContact::Property, DMessengerEvents::OnContactPhoneChange, DMessengerEvents::OnContactPagerChange, DMessengerEvents::OnContactFriendlyNameChange, DMessengerEvents::OnContactBlockChange