DMessengerEvents::OnMyPropertyChange Event
Deprecated. Indicates that an uncategorized element of the local client's property information has been changed or that a change was attempted.
Syntax
void OnMyPropertyChange( LONG hr, MCONTACTPROPERTY ePropType, VARIANT vPropVal );
Parameters
hr
[in] Success or error code as a LONG.Note 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.
ePropType
[in] A value in the MCONTACTPROPERTY enumeration.vPropVal
[in] A VARIANT that contains the current client user's new property information.
Return Value
No return value.
Event DISPID
DISPID_MUAE_ONMYPROPERTYCHANGE
The DISPID for this event is defined in msgrua.h. Use this value to identify the event handler when implementing IDispatch::Invoke.
Remarks
The Microsoft Windows Messenger API does not have a method to put or set the client's property information. This event fires only if the friendly name is changed through internal APIs or user action on the user interface (UI). To get the current client user properties, establish a MessengerContact object that corresponds to the current client user and call IMessengerContact::Property on that object.
This method exists primarily for as yet undefined properties. The current properties (Phone and FriendlyName ) have get_ methods for accessing the property in the Messenger object and their own specific change events.
To be used when writing custom ::Invoke methods to handle these events.
Parameter vaArgs[x] Variant Type vPropVal 0 VT_BSTR ePropType 1 VT_14 hr 2 VT_14 Note This event is available for scripting languages.
Important DMessengerEvents::OnMyPropertyChange is no longer available in Windows Vista. See Windows Messenger for more information.
See Also
DMessengerEvents::OnContactPropertyChange, IMessenger::MyPhoneNumber