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.

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

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