DMessengerEvents::OnMyPhoneChange Event

  • Article

Deprecated.  Indicates that the local client's phone contact information has been changed or that a change was attempted.

Syntax

void OnMyPhoneChange(      
    MPHONE_TYPE PhoneType,
    BSTR bstrNumber
);

Parameters

  • PhoneType
    [in] A value of the MPHONE_TYPE enumeration.
  • bstrNumber
    [in] A BSTR that contains the current client's new phone number. This might include punctuation, depending on how it is stored on the server.

Return Value

No return value.

Event DISPID

DISPID_MUAE_ONMYPHONECHANGE

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 friendly name information. This event fires only if the friendly name is changed through internal APIs or user action on the user interface (UI). No hr is contained in this event.

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

Parameter vaArgs[x] Variant Type
bstrNumber 0 VT_BSTR
PhoneType 1 VT_14

Note  This event is not available for scripting languages.

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

See Also

IMessenger::MyPhoneNumber, IMessengerContact::PhoneNumber, DMessengerEvents::OnContactPhoneChange