CM_Planner Configuration Service Provider (Windows Embedded CE 6.0)

1/6/2010

You can configure the preferred connections for each network using the CM_Planner configuration service provider. The configuration service provider can also control the settings for those connections.

Note

You must use this configuration service provider when provisioning devices using the OMA client provisioning protocol. For information about OMA client provisioning, see Configuring Device Connection Settings by using OMA XML. Access to this configuration service provider is determined by security roles.

The following image shows the configuration service provider in tree format as used by OMA client provisioning.

Characteristics

• PreferredConnections
  Parameters under this characteristic specify the preferred connection to use when connecting to a specific destination network.

Parameters

• <PreferredConnection>
  This parameter is used in the PreferredConnections characteristic to specify the preferred connection to use when connecting to a specific destination network. The name of the parameter must be a valid destination network GUID. The value of the parameter must be the entry name of a connection, which may be the initial node on a path connecting the device to the specified destination network. For example, the xml string <parm name="{436EF144-B4FB-4863-A041-8F905A62C572}" value="PPP4" /> will tell the planner to prefer the dialup connection PPP4 when connecting to the Internet.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Internet connection: Secure WAP connection: WAP connection: Work connection:
  Roles allowed to query and update setting	Manager AuthenticatedUser

• CacheTime
  Specifies the default time, in seconds, for which the planner will cache released connections. The following table shows the possible values.

  Value	Description
  0	None
  30	30 seconds
  60	1 minute
  300	5 minutes
  600	10 minutes

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Label	Idle disconnect after:
  Roles allowed to query and update setting	Manager AuthenticatedUser

  Connection Manager does not cache the following types of connections:

  • Suspended connections
  • Disconnected connections
  • Connections without a DestId (when the connection was provisioned using provisioning XML, a DestId was not specified)
  • Fixed path connections (a connection where the destination GUID is set to be an existing network connection managed using the Connection Manager)

• CoeffBandwidth
  Specifies a bandwidth coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Label	Bandwidth Coefficient
  Roles allowed to query and update setting	Manager AuthenticatedUser

• CoeffCost
  Specifies a cost coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Label	Cost Coefficient
  Roles allowed to query and update setting	Manager AuthenticatedUser

• CoeffLatency
  Specifies a latency coefficient, in 16.16 fixed point, for planner path calculations. The default value is 0x10000, which corresponds to 1.0.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Label	Latency Coefficient
  Roles allowed to query and update setting	Manager AuthenticatedUser

• FailoverDefault
  Sets the default value for the yes/no buttons of the failover prompt. Permitted values are 0 (zero) for no or or 1 for yes.

  Note

  The prompt has an internal timeout, so this also controls the default action if the user does not respond to the prompt within the time limit. If the failover prompt is disabled, this parameter also specifies whether failover is allowed.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Boolean
  Roles allowed to query and update setting	Manager AuthenticatedUser

• FailoverPrompt
  Specifies whether the planner displays a yes/no prompt before using a non-preferred connection, for example if the preferred connection is unavailable. The following table shows the possible values.

  Value	Description
  0	Do not display a prompt
  1	Display a prompt

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Boolean
  Roles allowed to query and update setting	Manager AuthenticatedUser

• RetryCount
  Specifies the number of times the planner retries failed connection attempts. Possible values for this parameter are 0, 1, 2, 3, 4 and 5. A value of 0 (zero) causes the planner to fail the connection attempt after the first try. A value of 1 causes the planner to retry the connection once.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Label	Redial attempts:
  Roles allowed to query and update setting	Manager AuthenticatedUser

Microsoft Custom Elements

The following table shows the Microsoft custom elements that this configuration service provider supports for OMA client provisioning.

Element Name	Description
noparm	Not supported
nocharacteristic	Supported
characteristic-query	Supported
parm-query	Supported

Use these elements to build standard OMA Client Provisioning configuration XML. For more information about these elements, see https://go.microsoft.com/fwlink/?LinkId=160786.

For information about OMA client provisioning, see Configuring Device Connection Settings by using OMA XML.

See Also

Concepts

Configuration Service Providers Overview

Other Resources

Configuration Service Providers