Export (0) Print
Expand All

IMessengerContext Interface

Ff750502.note(en-us,MSDN.10).gifNote:
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.

The IMessengerContext interface allows you to perform several common Messenger Connect actions for a user, such as signing a user in or out, specifying event handlers for a user, and sending messages.

Script:  http://js.live.net/4.1/loader.js
Feature:  Microsoft.Live
Namespace:  Microsoft.Live
 
Ff750502.alert_note(en-us,MSDN.10).gifNote

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 and implementing interfaces, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Microsoft.Live.IMessengerContext = function();
Microsoft.Live.IMessengerContext.registerInterface(
    'Microsoft.Live.IMessengerContext');

The IMessengerContext interface defines methods and properties for performing common Messenger Connect tasks.

The following example demonstrates how to use the messenger context to authenticate a user after the user is signed in.

//Get the application context and declare namespace resources.
function appOnload(evtArgs) {
    Microsoft.Live.Core.Namespace.using("wl:Microsoft.Live");
    Microsoft.Live.Core.Namespace.using("msgr:Microsoft.Live.Messenger");
    appContext = evtArgs.get_dataContext();
    auth = wl.App.get_auth();
}
//Sign in the user and specify the onSignIn callback method.
function signInUser()
{
    var status = Microsoft.Live.Messenger.PresenceStatus.online;
    messengerContext.signIn(status, onSignIn);
}
//Authenticate the user. If authentication fails, display an alert. If it succeeds, get the messenger context.
function onsignIn() {
   if (auth) {
        if (auth.get_state() == Microsoft.Live.AuthState.failed) {
            alert("Authentication failed.");
            return;
        }
        else if (auth.get_state() == Microsoft.Live.AuthState.authenticated) {
           alert("Authentication succeeded.");
        }
   }
}

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

Show:
© 2014 Microsoft