See Also
 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. |
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
- w2
- 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