[OnContactPhoneChange is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Indicates that the phone information of a contact in the local client's Contact List has changed.
void OnContactPhoneChange( [in] LONG hr, [in] IDispatch *pContact, [in] MPHONE_TYPE PhoneType, BSTR bstrNumber );
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.
A MessengerContact object that corresponds to the contact.
A value in the MPHONE_TYPE enumeration.
A BSTR that contains the string of the phone number.
This event does not return a value.
Due to user input, the bstrNumber string might or might not contain punctuation. In general, punctuation is useful for display in the UI, but not for handling by APIs that handle telephony. Clients can strip or parse punctuation. However, punctuation cannot be added if none has been preserved because there are many possible punctuation conventions in various locales.
To be used when writing custom ::Invoke methods to handle these events.
This event is not available for scripting languages.
|Minimum supported client
||Windows 2000 Professional, Windows XP [desktop apps only]
|Minimum supported server
||Windows Server 2003 [desktop apps only]
|End of client support
|End of server support
||Windows Server 2003