ApplicationContactCollection Class

Current information about Live Connect is now available in the Windows Live Developer Center. The information in the following sections is provided for legacy purposes only.

Represents a collection of application-specific Contact objects.

Feature:  Messenger.Core
Namespace:  Microsoft.Live.Messenger.Applications

The JavaScript Library for Windows Live Messenger Connect is built by using the Microsoft Ajax Library. Microsoft Ajax exposes a type system that enables you to add object-oriented capabilities to your JavaScript code. To learn more about creating, instantiating, and deriving from classes, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Microsoft.Live.Messenger.Applications.ApplicationContactCollection = function();


The application can maintain an application-specific list of application contacts for the user that appear when the user is signed in to the application. The user subscribes to the contacts in this list and the user receives the current presence information for each of them. These contacts are in the applicationContacts collection of User.

The user's application-specific contacts are not persisted within Windows Live. The application is responsible for providing the Messenger Web Toolkit these contacts each time the user signs in. The application can provide an initial set of contacts using the setContacts(String, String) method. The application must provide these contacts in a well-formed XML document along with a signature that verifies the integrity of the document.

Windows Live is responsible for ensuring that permissions between two users are properly enforced. A user can normally only see the presence of another user if the other user has the user on his or her allow list. However, since not all relationships between users are known to Windows Live, application contacts can be used to express these application-specific relationships.

When an application provides a list of application contacts, Windows Live delegates permissions to the application. Essentially, Windows Live lets an application decide which of its users can see the presence of and communicate with other users. Note that an application cannot make this decision for any user that has not specifically granted permission to the application to do so.


Windows Live Messenger Connect

Supported in: 4.1

Windows Live Messenger Web Toolkit

Supported in: 3.7, 3.5, 3.1, 3.0

Internet Explorer 8.0, Internet Explorer 7.0, Internet Explorer 6.0, Firefox 3.6, Firefox 3.5, Firefox 3.0, Firefox 2.0, Firefox 1.5, Chrome 4.0, Chrome 3.0, Chrome 2.0, Chrome 1.0, Safari 4.0, Safari 3.0, Opera 10.5