NetworkPolicy Configuration Service Provider

4/8/2010

Use the NetworkPolicy Configuration Service Provider to configure network policy settings. The NetworkPolicy Configuration Service Provider is used for Bluetooth, IrDA, and Wi-Fi.

The NetworkPolicy Configuration Service Provider can be managed over both Open Mobile Alliance Device Management (OMA DM) protocol and 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 NetworkPolicy Configuration Service Provider object in tree format as used by OMA DM.

Cc515002.c5b71b4a-32f4-4cae-8a13-dd709df9f54f(en-us,MSDN.10).gif

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

Cc515002.222d5c0a-9a6d-4653-a4e4-75782db085fd(en-us,MSDN.10).gif

Characteristics

  • NetworkPolicy
    Describes the root node of the NetworkPolicy management object.

    Data type

    Node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

  • Bluetooth
    Describes the NetworkPolicy for Bluetooth.

    Data type

    Node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

  • Settings
    See the following section for information about the only supported parameter, Disabled.

    Data type

    node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

  • AllowedProfiles
    See the following section for information about the only supported parameter, <x>.

    Data type

    node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

  • IrDA
    Describes the NetworkPolicy for IrDA.

    Data type

    node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

  • Wi-Fi
    Describes the NetworkPolicy for Wi-Fi.

    Data type

    node

    Access Type

    Get

    Scope

    Permanent

    Occurs

    One

Parameters

  • Disabled
    Disables a corresponding network interface, such as Bluetooth, IrDA, or Wi-Fi.

    If the value of this parameter is set to 1, the corresponding network interface is disabled. If any other value is specified, or if the parameter is missing altogether, the corresponding network interface is enabled.

    Data type

    bool

    Access Type

    Add, Get, Replace

    Scope

    Dynamic

    Occurs

    ZeroOrOne

  • <x>
    Identifies the set of parameters to represent the Bluetooth profiles that are allowed. A string UUID such as "{0000111F-0000-1000-8000-00805F9B34FB}" is used as the parameter name. The value of the parameter is ignored.

    Note

    In the NetworkPolicy Configuration Service Provider, the GUID must be enclosed within the LocURI by braces {}. In OMA Client Provisioning, the brackets can be entered directly. For OMA DM, ASCII values of %7B and %7D must be used respectively, in place of opening and closing braces.

    Data type

    null

    Access Type

    Add, Get, Delete, Replace

    Scope

    Dynamic

    Occurs

    ZeroOrMore

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

No

characteristic-query

Yes

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 OMA Client Provisioning XML File Examples.

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

See Also

Concepts

Configuration Service Provider Reference for Windows Mobile Devices
NetworkPolicy Configuration Service Provider Examples for OMA DM
NetworkPolicy Configuration Service Provider Examples for OMA Client Provisioning
NetworkPolicy DDF File