BrowserFavorite Configuration Service Provider

4/8/2010

The BrowserFavorite Configuration Service Provider adds and removes URLs from the favorites list on a device and specifies the order in which favorites appear in the list. This Configuration Service Provider manages only the favorites at the root favorite folder level. It does not managing subfolders under the root favorite folder nor manage favorites under a subfolder.

Note

By default, Favorites are listed alphabetically.

Note

This Configuration Service Provider is supported by the OMA Client Provisioning (formerly WAP 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 Roles and Default Roles for Configuration Service Providers.

The following image shows the Configuration Service Provider in tree format as used by OMA Client Provisioning.

Bb737405.421abf01-9853-4e28-b023-b90ffc4dae4e(en-us,MSDN.10).gif

Characteristics

  • <favorite name>**
    Identifies the user-friendly name of the favorite URL that is displayed in the Internet Explorer Mobile Favorites list. It should contain only characters that are valid in the Windows Mobile file system.

    The type attribute of this characteristic must not be empty and the value of the type must not be a URL.

Parameters

  • URL
    Specifies the complete URL for the favorite that is named in the <favorite name> characteristic type tag.

    The following table shows the default settings.

    Permissions

    Read/Write

    Data type

    String

    Label

    Favorites

    Semantic Type

    url

    Roles allowed to query and update setting

    Manager

    AuthenticatedUser

  • Order
    Specifies the position of the Favorite in the list. A value of zero (0) is the first position of the Favorites list.

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this Configuration Service Provider supports for OMA Client Provisioning.

Elements Available

parm-query

Yes

noparm

Yes

nocharacteristic

Yes

characteristic-query

Yes

Recursive: Yes

Root level of the Configuration Service Provider: No

Use these elements to build standard OMA Client Provisioning (formerly WAP Client Provisioning) configuration XML. For information about specific elements, see MSPROV DTD Elements. For examples of how to generally use the Microsoft custom elements, see Provisioning XML File Examples.

For information about OMA Client Provisioning, see OMA Client Provisioning Files.

See Also

Tasks

BrowserFavorite Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices

Other Resources