Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

An APPLICATION configuration service provider that has an APPID of w2 is used to configure browser favorites.

The w2 APPLICATION configuration service provider is managed over OMA Client Provisioning protocol.

Note:
Access to this configuration service provider is determined by security roles. Because OEMs and mobile operators can selectively disallow access, ask them about the availability of this configuration service provider. For more information about roles, see Security Rolesand Default Roles for Configuration Service Providers.

In the root characteristic, the default security roles are defined. The default security role maps to each subnode unless specific permission is granted to the subnode. The following table shows the default settings.

Access type

Read/Write

Roles allowed to query and update setting

Manager

Operator

Operator - TPS

The following image shows the configuration service provider management object in tree format as used by OMA Client Provisioning.

Characteristics

RESOURCE

A list of favorites, also known as bookmarks, each identified by an item tag.

Access type

Read/Write

Data type

node

Occurs

OneOrMore

Parameters

APPID

Differentiates the types of available services and protocols. This parameter is used in the APPLICATION characteristic.

The only valid value to configure the OMA Client Provisioning w2 APPID is:

  • w2

The following table shows the default settings.

Access type

Read/Write

Data type

string

Occurs

One

NAME

The NAME parameter is used in the APPLICATION characteristic to specify a user readable folder identity. This parameter is used to define part of the registry path.

In Windows Mobile Version 5.0-based devices the NAME parameter under the APPLICATION characteristic is optional, but is highly recommended. It is used to specify the name of the folder in which the favorites should be placed. For example, if you are creating a favorite, this value would be the name of the folder where the favorite is created. You can specify only one folder for each APPLICATION section.

Note:
Favorites only supports a folder structure one level deep. If this parameter is not provided, the favorite is created at the root level.

The NAME parameter is used in the RESOURCE characteristic to specify the user readable name of the favorite. Under the RESOURCE characteristic the NAME parameter is required.

Note:
The W2 APPLICATION configuration service provider cannot add a favorite with the same NAME as an existing favorite. A new favorite with the same name is ignored.

The following table shows the default settings.

Access type

Read/Write

Data type

string

Occurs in APPLICATION

ZeroOrOne

Occurs in RESOURCE

OneOrMore

Order

The Order parameter is used in the RESOURCE characteristic to specify the order that the favorite should appear in the list. A value of 0 is the first position

Note:
This parameter is only valid for Windows phones.

The following table shows the default settings.

Access type

Read/Write

Data type

string

Occurs

ZeroOrOne

STARTPAGE

The STARTPAGE parameter is used in the RESOURCE characteristic to set the browser start page. Use this parameter to indicate if a favorite is a start page. On Windows phones, the Start page is added to the list of favorites.

Although there can be multiple resource characteristics under the w2 APPID, only one of them should have the STARTPAGE parameter set. If more than one start page is specified, the last one processed is set as the start page.

Access type

Read/Write

Data type

bool

Occurs

ZeroOrOne

URI

The URI parameter is used in the RESOURCE characteristic to specify the absolute URI for the favorite.

Access type

Read/Write

Data type

URI

Occurs

OneOrMore

See Also