Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

getOnlineContacts Method

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.

Returns a collection of the signed-in user's online contacts.

Script:  http://js.live.net/4.1/loader.js
Feature:  Microsoft.Live
Namespace:  Microsoft.Live

var sortedContactCollection = instance.getOnlineContacts();

Return Value

Returns an observable array that contains all of the user's contacts that are currently online.

Applications can listen for changes to the array with the INotifyCollectionChanged interface.

The following example demonstrates how to send a predefined message to each online contact.

//Get the messenger context and the array of the user's contacts that are currently online.
messengerContext = wl.App.get_messengerContext();
var onlineContacts = messengerContext.getOnlineContacts();
var message = new Microsoft.Live.Messenger.TextMessage("Hello!");
//Send the pre-defined message to each contact in the list.
for (i = 0; i < onlineContacts.get_count(); i++) 
   var contact = onlineContacts.get_item(i);
   messengerContext.sendMessage(contact.get_cid(), message)

Windows Live Messenger Connect

Supported in: 4.1

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

© 2015 Microsoft