Share via


Connection Manager Registry Settings (Windows Embedded CE 6.0)

1/6/2010

This topic describes the registry settings that you can use to configure Connection Manager.

Suspend-and-Resume

The HKEY_LOCAL_MACHINE\Comm\ConnMgr\Planner\Settings registry key controls the Suspend-and-Resume behavior of a connection. A connected Suspend-and-Resume-capable connection does not have to be disconnected when a voice call is connected. If the network does not support simultaneous voice and data (SVD), the data connection goes into a suspended state during a voice call and cannot send or receive any data.

For more information, refer to Making a Suspend-and-Resume Data Connection During a Voice Call.

The following table shows the values under this registry key.

Value Type Description

SuspendResume

REG_MULTI_SZ

This value specifies connections that are Suspend-and-Resume capable and can remain connected even when they are not being used by any application.

To specify a GSM or CDMA Suspend-and-Resume packet data connection, set this value to the dial string that must be dialed to make this connection. The dial string lists the connection by its APN, for GSM, or by dial number for CDMA. The dial string uses hexadecimal values and comma delimiters. You can specify multiple dial strings.

The default value of SuspendResume is set to the ~GPRS! dial string. This is the dial string, or dial string prefix, that applies to all GSM packet data connections and specifies that they all should be treated as Suspend-and-Resume capable. By default, CDMA data connections are not Suspend-and-Resume capable and therefore do not have a SuspendResume registry value.

The following registry key example shows how to set this value:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ConnMgr\Planner\Settings]
  "SuspendResume"=hex(7):\
        7e,47,50,52,53,21,00,00,00,00

To disable the feature, set the value to a null string.

RetryCount

REG_DWORD

Specifies the number of retry attempts Connection Manager makes to reestablish a connection. Default is 4.

Ee497330.note(en-US,WinEmbedded.60).gifNote:
The Cellcore.reg file sets this value to 1.

CacheTime

REG_DWORD

Specifies the number of seconds that a non-exclusive connection request remains cached. Such connections typically do not use a VPN. Default is 60.

This cache time applies only if the default cache time was specified when the non-exclusive connection request was previously released. This happens if an application previously called ConnMgrReleaseConnection to release the connection, and the lCache parameter was set to 1.

VPNCacheTime

REG_DWORD

Specifies the number of seconds that an exclusive connection request, such as a VPN connection request, remains cached. Default is 60.

This cache time applies only if the default cache time was specified when the non-exclusive connection request was previously released. This happens if an application previously called ConnMgrReleaseConnection to release the connection, and the lCache parameter was set to 1).

CoeffCost

REG_DWORD

Specifies the cost coefficient for the connection. Default is 10000.

CoeffLatency

REG_DWORD

Specifies the latency coefficient for the connection. Default is 10000.

CoeffBandwidth

REG_DWORD

Specifies the bandwidth coefficient for the connection. Default is 10000.

AlwaysOnRetryInterval

REG_DWORD

Specifies in milliseconds how frequently Connection Manager tries to connect a disconnected AlwaysOn data connection. Default is 1,800,000, which equates to 30 minutes. For more information about AlwaysOn data connections, see AlwaysOn Data Connections.

Note

Provision all other connection attributes by using Configuration Service Providers. For more information, see Connection Manager Configuration.

See Also

Other Resources

Connection Manager Configuration
Connection Manager