This topic summarizes the new features that have been introduced in the Windows Live Messenger Library. Version 2.5 of the Windows Live Messenger Library is fully backward compatible with versions 2.0 and 1.0.

Changes in Version 2.5
New Messenger Script URL
New Features
Contact Presence
The new Contact.Presence property returns presence information for contacts. Previously, presence information was only available via IMAddress.Presence. The new property should simplify application development because most applications can rely on Contact.Presence.
Contact Display Names
The new Contact.DisplayName property returns the name that applications should use when rendering a contact. This property is dynamically computed based on various values including the contact's current display name as well as the user's nickname for the contact.
Contact Nicknames
Windows Live Messenger enables users to provide nicknames for their contacts. Applications can now read and write nicknames using the Contact.Nickname property.
Endpoint Names
The user's Endpoints now expose their human-friendly names via the Name property. Applications can also customize the name of the local endpoint.
Showing and Hiding Sign-in Control
Improvements have been made to the reliability of the Sign-in Control. The control can be displayed and hidden using the new Show and Hide methods.
Item Accessors
All collection types now expose an item accessor to retrieve items from the collection. Applications no longer need to enumerate through a collection to retrieve specific items.
Browser Support
Firefox® 3.0 is now an officially supported browser.

Changes in Version 2.0
New Messenger Script URL
The Messenger Script URL has been updated to: http://www.wlmessenger.net/2.0/messenger.js. Note that both the host name and the version have been changed.
New Features
Contact Display Pictures
The DisplayPictureUrl property now returns a display picture URL for contacts. Previously, the display picture URL was only available for the signed in user.
Online and Offline Contacts Collections
Messenger applications often show contacts sorted by status (for example, a list of online contacts followed by a list of offline contacts). Because this is a common programming construct, it is now supported directly by the OnlineContacts and OfflineContacts properties. For more information, see How To: Monitor Presence.
CID (public unique identifier)
The CID is an identifier for Messenger contacts. This value can now be obtained for the currently signed-in user, and all Messenger contacts, as a property of the IMAddress Class.
URL Strings for Windows Live Messenger Resources
The SignInControlLinks property is a collection of URL strings for various Windows Live and Windows Live Messenger resources. This property is exposed through the Sign-in Control. You can use the URLs provided by this property to display links to these resources on your Web site. URL strings for the following pages are available:
-
About Windows Live Messenger
-
Change account
-
Privacy statement
-
Send feedback
-
Change settings
-
Sign Up for a Windows Live ID
-
Terms of use
For more information, see How To: Access Messenger Resources.
Messenger Logo and Presence Icons
You can access the full set of Messenger logo icons and presence icons for use in the user interface of your applications. For more information, see How To: Access Messenger Resources.
User Session Status
The user's current session status can now be obtained by using the User.Status property. This property indicates the following states:
-
Signed out
-
Signing in
-
Signed in
-
Signing out
For more information, see Status Property and How To: Host the Sign-in Control.
Sign-in Control Stylization
Sign-in Control Returns Extended Authentication Results
The Sign-in Control has been updated to return extended authentication results. For example, notification is returned if an unsupported browser is in use or if a user is already signed in to Messenger. As in the previous version, authentication results are only returned if authentication succeeds. For more information, see How To: Host the Sign-in Control.
New Topics
How To: Implement Custom Presence
Custom presence provides a means to create custom presence properties. You can use custom presence properties to enable users to publish presence information for other users to see. For more information, see How To: Implement Presence Extensions.
How To: Implement Custom Messaging
Custom messaging provides a way to create custom application message types that can extend the functionality of a messaging client by facilitating the exchange of different types of data. For more information, see How To: Implement Messaging Extensions.
Messenger Resources