Application Control

Ff748419.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 App control provides application configuration metadata that identifies your application to Windows Live Services. It is represented in markup by the app tag.

The following example shows how to insert the App control into a webpage.

JScript
Copy 
<wl:app
   channel-url="http://<Your-Domain>/channel.html"
   callback-url="http://<Your-Domain>/OAuthWrapCallback.axd"
   client-id="<Client ID assigned at provisioning time>"
   privacy-url="http://<Your-Domain>/"
   scope="<List of offers to grant at signin>">
</wl:app>

The following table lists the attributes for the App control.

Name Type Required Default Value Description

application-group-name

String

No

none

Sets the name of the application group that the application belongs to.

application-icon

String

No

none

Sets a URL that references the application's icon, which appears in the contact list when the application has provided application contacts. Each application icon should be 16 x 16 pixels.

application-logo

String

No

none

Sets the URL of the application logo, which appears when the application asks the user to grant consent. If no application logo is provided, a question mark image is shown instead. Each application logo should be 96 x 96 pixels.

application-name

String

No

none

Sets the application name.

audio-enabled

Boolean

No

true

Sets whether audio is enabled.

channel-url

String

Yes

none

Sets the URL of the channel.html file in the client's domain.

callback-url

String

Yes

none

Sets the URL of the OAuth Wrap callback handler (.axd) in the client's domain.

client-id

String

Yes

none

Sets the client ID that was assigned when the application was initially provisioned.

client-state

String

No

none

Sets an arbitrary string value that can be used by the application to identify state at sign in time.

privacy-url

String

Yes

none

Sets the privacy policy URL of the application.

signin-enabled

Boolean

No

true

Sets a value indicating whether Messenger sign-in is enabled.

token-url

String

No

none

Sets the URL to the token processing page of the application.

scope

String

Yes

none

Specifies a list of offers to grant at sign in time. For example, wl_Contacts.View. Use a comma (no white space) to separate multiple values. For more information, see Messenger Connect Scopes.

onload

Function Callback

No

none

Specifies the event handler function to call when the App control has finished loading.

The App Control provides the initialization information that is necessary if you use Messenger Connect UI controls on a page. Exactly one App tag must be defined on each page that contains other controls.

The App tag does not render output and therefore does not have customization options such as templating.

Show: