[OnMyFriendlyNameChange is no longer available in Windows Vista. See Windows Messenger for more information.]
Indicates that the local client's friendly name has been changed or that a change was attempted.
void OnMyFriendlyNameChange( [in] LONG hr, [in] BSTR bstrPrevFriendlyName );
- hr [in]
Success or error code as LONG. S_OK is the only result returned currently.
- bstrPrevFriendlyName [in]
A BSTR that contains the current client user's previous friendly name.
Return ValueThis event does not return a value.
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.
After receiving this event, the following call should be issued immediately to get the new friendly name of the current client user.
The previous friendly name might be permanently lost if it were not returned in the events. It can be used to check the client UI to be sure it is removed.
To be used when writing custom ::Invoke methods to handle these events.
Note This event is not available for scripting languages.
Minimum supported client
|Windows 2000 Professional, Windows XP|
Minimum supported server
|Windows Server 2003|
Build date: 6/30/2010