Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

DMessengerEvents::OnMyPropertyChange Event

[OnMyPropertyChange is no longer available in Windows Vista. See Windows Messenger for more information.]

Indicates that an uncategorized element of the local client's property information has been changed or that a change was attempted.

Syntax

void OnMyPropertyChange(
  [in]  LONG hr,
  [in]  MCONTACTPROPERTY ePropType,
  [in]  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

This event does not return a value.

Remarks

The 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 UI. To get the current client user properties, establish a MessengerContact object that corresponds to the current client user and call 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.

ParametervaArgs[x]Variant Type
vPropVal0VT_BSTR
ePropType1VT_14
hr2VT_14

 

Note  This event is available for scripting languages.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP

Minimum supported server

Windows Server 2003

Product

Messenger 4.5

Header

Msgrua.h

IDL

Msgrua.idl

DLL

Msgsc.dll

See Also

DMessengerEvents
OnContactPropertyChange
MyPhoneNumber

 

 

Send comments about this topic to Microsoft

Build date: 6/30/2010

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.