DMessengerEvents::OnMyPhoneChange event

[OnMyPhoneChange is no longer available for use as of Windows Vista. See Windows Messenger for more information.]

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

Syntax

void OnMyPhoneChange(
  [in] MPHONE_TYPE PhoneType,
  [in] 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

This event does not return a value.

Remarks

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

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

MyPhoneNumber

PhoneNumber

OnContactPhoneChange