CM_GPRSEntries Configuration Service Provider

4/8/2010

This Configuration Service Provider configures the General Packet Radio Service (GPRS) entries on the device.

The following table shows the default settings. The default security role maps to each subnode unless specific permission is granted to the subnode.

Permissions	Read/Write
Roles allowed to query and update setting	Manager Operator AuthenticatedUser

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

Characteristics

• < entryname >
  Specifies the name of the connection. Fields under this characteristic specify parameters for this connection.

  Note

  The operating system does not allow duplicate entry names among the CM_VPNEntries, CM_PPPEntries, and CM_GPRSEntries Configuration Service Providers.

• <entryname>/DevSpecificCellular
  Used to set parameters in the device-specific structure which is passed by RAS to the cellular TAPI device by the lineSetDevConfig parameter before initiating the connection. This characteristic is only valid for connections that use the cellular TAPI service provider.

• <entryname>/DevSpecificUnimodem
  Used to set parameters in the device-specific structure that is passed by RAS to the unimodem TAPI device by the lineSetDevConfig parameter before initiating the connection. This characteristic is only valid for connections that use the unimodem TAPI service provider, and therefore would not typically be used by GPRS connections.

Parameters

• AltDnsAddr
  Used in the <entryname> characteristic. This value is placed in the ipaddrDnsAlt member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  Note

  Once configured, the AltDnsAddr parameter cannot be set to null by configuration with a blank string. The only way to change the setting is to pass in the value "0.0.0.0".

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Secondary DNS:
  Semantic	phone-number
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• AltWinsAddr
  Used in the <entryname> characteristic and is placed in the ipaddrWinsAlt member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• AlwaysOn
  Used in the <entryname> characteristic to specify whether the connection supports AlwaysOn. Permitted values are false (AlwaysOn not supported) and true (AlwaysOn supported).

  The following table shows the default settings.

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

• AreaCode
  Specifies the area code portion of the phone number. This parameter is used in the <entryname> characteristic and is placed in the szAreaCode member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  This field should not be configured for GPRS connections.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• BearerInfoConnectionElement
  Used in the <entryname>/DevSpecificCellular characteristic. This parameter is placed in the dwConnectionElement member of the CELLDEVCONFIG structure.

  See GSM specification 07.07 "6.7 Select bearer service type +CBST" for more information. The following table lists the possible values.

  Value	Description
  1	Transparent
  2	NonTransparent
  3	BothTransparent
  4	Both NonTransparent

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• BearerInfoService
  This parameter is used in the <entryname>/DevSpecificCellular characteristic. The parameter is placed in the dwService member of the CELLDEVCONFIG structure. Permitted values are one of the CELLDEVCONFIG_SERVICE_* values defined in tsp.h. See GSM specification 07.07 "6.7 Select bearer service type +CBST" for more information. The following table lists the possible values.

  Value	Description
  1	Async Modem
  2	Sync Modem
  3	Async PAD Access
  4	Sync Packet Access

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• BearerInfoSpeed
  This parameter is used in the <entryname>/DevSpecificCellular characteristic. The parameter is placed in the dwSpeed member of the CELLDEVCONFIG structure. Permitted values are one of the CELLDEVCONFIG_SPEED_* values defined in tsp.h. See GSM specification 07.07 "6.7 Select bearer service type +CBST" for more information. The following table lists the possible values.

  Value	Description
  1	Auto
  2	300 v21
  3	300 v110
  4	12000 v22
  5	1200/75 v23
  6	1200 v110
  7	1200 v120
  8	2400 v22bis
  9	2400 v26ter
  10	2400 v110
  11	2400 v120
  12	4800 v32
  13	4800 v110
  14	4800 v120
  15	9600 v32
  16	9600 v34
  17	9600 v110
  18	9600 v120
  19	14400 v34
  20	14400 v110
  21	14400 v120
  22	19200 v34
  23	19200 v110
  24	19200 v120
  25	28800 v34
  26	28800 v110
  27	28800 v120
  28	38400 v110
  29	38400 v120
  30	48000 v110
  31	48000 v120
  32	56000 v110
  33	56000 v120
  34	56000 Transparent
  35	64000 Transparent

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• BearerInfoValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other bearer information parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bBearerInfoValid member of the CELLDEVCONFIG structure.

  The following table shows the default settings.

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

• CompressionInfoDirection
  This parameter is used in the <entryname>/DevSpecificCellular characteristic. The parameter is placed in the dwDirection member of the CELLDEVCONFIG structure.

  See "ITU-T Recommendation V.25 ter" Section 6.6.1 for more information. The following table lists the possible values.

  Value	Description
  1	None
  2	Transmit
  3	Receive
  4	Both

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• CompressionInfoMaxDictEntries
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to control the maximum number of dictionary entries for V.42bis data compression. The value is placed in the dwMaxDictEntries member of the CELLDEVCONFIG structure.See "ITU-T Recommendation V.25 ter" Section 6.6.1 for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• CompressionInfoMaxStringLength
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to control the maximum string length for V.42bis data compression. The value is placed in the dwMaxStringLength member of the CELLDEVCONFIG structure.See "ITU-T Recommendation V.25 ter" Section 6.6.1 for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• CompressionInfoRequired
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether data compression is required. Permitted values are 0 for OFF or 1 for ON. This value is placed in the dwRequired member of the CELLDEVCONFIG structure. See "ITU-T Recommendation V.25 ter" Section 6.6.1 for more information.

  The following table shows the default settings.

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

• CompressionInfoValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other radio link information parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bDataCompInfoValid member of the CELLDEVCONFIG structure.

  The following table shows the default settings.

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

• CountryCode
  This numeric parameter is used in the <entryname> characteristic and is placed in the dwCountryCode member of the RASENTRY structure. This parameter specifies the country/region code portion of the phone number. For more information about RASENTRY, see MSDN.

  This field should not be configured for GPRS connections.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Desc.<langid>
  This parameter is used in the <entryname> characteristic. A tag in the format of Desc.<langid> will be used as the language specific identifier for the specified entry. For example, the field <parm name="Desc.0409" value="PPP Dialup" /> will force "PPP Dialup" to be displayed in the UI to represent this connection when the phone is set to English language (language ID 0409). Descriptions for multiple languages may be provisioned using this mechanism, and the system will automatically switch among them if the user changes language preferences on the phone. If no Desc tag is provisioned for a given language, the system will default to the characteristic tag name used to create the entry.

• DestId
  This parameter is used in the <entryname> characteristic as a GUID that represents the unique ID of the network to which this entry connects. See the connmgr.h header file for predefined GUID values IID_DestNet*.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Connects to
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• DeviceName
  This parameter is used in the <entryname> characteristic. The parameter is placed in the szDeviceName member of the RASENTRY structure, and specifies the local portion of the phone number. This string contains the name of a TAPI device to use with this phone-book entry, for example "XYZ Corp 28800 External". For more information about RASENTRY, see MSDN.

  To enumerate the number of available RAS-capable devices, use the lineInitialize function. For Windows Mobile Standard, by default, this member contains the name of the cellular TAPI device (specified in the tsp.h header file) of "Cellular Line".

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• DeviceSpecificRAW
  This parameter is used in the <entryname> characteristic to allow querying or setting the TAPI device-specific data structure associated with the RAS entry. This duplicates the functionality of the various XML tags under the DevSpecificCellular and DevSpecificUnimodem characteristics, and also allows the setting of the device-specific information for other non-standard TAPI service providers.

  The string value is interpreted as a hexadecimal byte stream, for example the string "FFFFFFFF" will set the structure to a single DWORD with all bits set. The resulting structure is passed into the TAPI service provider through lineSetDevConfig each time the connection is brought up.

  Note

  This parameter should be used with caution because it allows direct manipulation of the underlying data

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• DeviceType
  This parameter is used in the <entryname> characteristic and is placed in the szDeviceType member of the RASENTRY structure. The default value is RASDT_Modem. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• DialAsLocalCall
  This parameter is used in the <entryname> characteristic to control the setting of the RASEO_DialAsLocalCall member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRY and the use of this parameter, see MSDN.

  Note

  For cellular devices, this parameter is typically ignored, and the system is programmed to dial the full canonical number, for example "+<country/region code><area code><local number>".

  The following table shows the default settings.

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

• DnsAddr
  This parameter is used in the <entryname> characteristic and is placed in the ipaddrDns member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  Note

  Once configured, the DnsAddr parameter cannot be set to null by configuration with a blank string. The only way to change the setting is to pass in the value "0.0.0.0".

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Primary DNS:
  Semantic Type	phone-number
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Domain
  This parameter is used in the <entryname> characteristic and is placed in the szDomain member of the RASDIALPARAMS structure. This parameter specifies the domain to be used during authentication. For more information about RASDIALPARAMS, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Domain:
  Semantic type	url
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Enabled
  This parameter is used in the <entryname> characteristic to enable or disable a connection entry without removing it from the system. Permitted values are 0 for OFF or 1 for ON.

  The following table shows the default settings.

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

• FrameSize
  This parameter is used in the <entryname> characteristic and is placed in the dwFrameSize member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Framing
  This parameter is used in the <entryname> characteristic and is placed in the dwFramingProtocol member of the RASENTRY structure. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoAccessPointName
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the logical name to select the GPRS gateway. The value is placed in the wszAccessPointName member of the CELLGPRSCONNECTIONINFO structure.

  See GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information.

  Note

  When using an XML provisioning file to configure Windows Mobile Professional and Windows Mobile Classic GPRS entries, the APN value will be set, but will not be seen in the user interface. The user interface shows the APN as blank.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoAddress
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the packet address to use on the connection. The value is placed in the wszAddress member of the CELLGPRSCONNECTIONINFO structure.

  See GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoDataCompression
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to control PDP data compression. See CELLGPRSCONNECTIONINFO and the GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information. The following table lists the possible values. The following table lists the possible values.

  Value	Description
  0	CELLDEVCONFIG_GPRSCOMPRESSION_UNKNOWN, compression status unknown.
  1	CELLDEVCONFIG_GPRSCOMPRESSION_OFF, compression off.
  2	CELLDEVCONFIG_GPRSCOMPRESSION_ON, compression on.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoHeaderCompression
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to control PDP header compression. See CELLGPRSCONNECTIONINFO and the specification GSM 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information. The following table lists the possible values.

  Value	Description
  0	CELLDEVCONFIG_GPRSCOMPRESSION_UNKNOWN, compression status unknown.
  1	CELLDEVCONFIG_GPRSCOMPRESSION_OFF, compression off.
  2	CELLDEVCONFIG_GPRSCOMPRESSION_ON, compression on.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoL2ProtocolType
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the protocol for level 2 information transmission. See CELLGPRSCONNECTIONINFO for more information about this parameter. See GSM specification 07.07 "10.1.6 Enter data state +CGDATA" for more information. The following table lists the possible values.

  Value	Description
  1	NULL
  2	PPP
  3	PAD
  4	X25

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoMinQOSDelayClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile delay class.

  See GSM specification 07.07 "10.1.3 Quality of Service Profile (Minimum acceptable) +CGQMIN" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	Predictive 1
  3	Predictive 2
  4	Predictive 3
  5	Best Effort

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoMinQOSMeanThruClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile mean throughput class. See CELLGPRSQOSSETTINGS in the for more information about this parameter. See GSM specification 07.07 "10.1.3 Quality of Service Profile (Minimum acceptable) +CGQMIN" for more information. The following table lists the possible values.

  The following table shows the default settings:

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoMinQOSPeakThruClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile peak throughput class. See CELLGPRSQOSSETTINGS for more information about this parameter. See GSM specification 07.07 "10.1.3 Quality of Service Profile (Minimum acceptable) +CGQMIN" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	8000
  3	16000
  4	32000
  5	64000
  6	128000
  7	256000
  8	512000
  9	1024000
  10	2048000

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoMinQOSPrecedenceClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile precedence class. Permitted values are one of the CELLDEVCONFIG_GPRSPRECEDENCECLASS_* values specified in the tsp.h header file. See GSM specification 07.07 "10.1.3 Quality of Service Profile (Minimum acceptable) +CGQMIN" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	High
  3	Normal
  4	Low

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoMinQOSReliabilityClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile reliability class. Permitted values are one of the CELLDEVCONFIG_GPRSRELIABILITYCLASS_* values specified in the tsp.h header file. See GSM specification 07.07 "10.1.3 Quality of Service Profile (Minimum acceptable) +CGQMIN" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	Class 1
  3	Class 2
  4	Class 3
  5	Class 4
  6	Class 5

  The following table shows the default settings

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator - TPS AuthenticatedUser

• GPRSInfoMinQOSSettingsValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other Minimum Quality of Service parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bMinimumQOSSettingsValid member of the CELLGPRSCONNECTIONINFO structure associated with the connection.

  The following table shows the default settings.

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

• GPRSInfoParameters
  This parameter is used in the <entryname>/DevSpecificCellular characteristic for specifying Protocol-specific values when defining a GPRS context. This parameter specifies a text string that is placed in the szParameters member of the CELLGPRSCONNECTIONINFO structure.

  See GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information.

  The following table shows the default settings.

  Permissions	Read/write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoProtocolType
  This parameter is used in the <entryname>/DevSpecificCellular characteristic. See CELLGPRSCONNECTIONINFO for more information about this parameter. See GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information. The following table lists the possible values.

  Value	Description
  1	X25
  2	IP
  3	IHOSP
  4	PPP

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoQOSDelayClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested Quality of Service Profile delay class. See CELLGPRSQOSSETTINGS for more information about this parameter. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	Predictive 1
  3	Predictive 2
  4	Predictive 3
  5	Best Effort

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager, Operator - TPS AuthenticatedUser

• GPRSInfoQOSMeanThruClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested Quality of Service Profile mean throughput class. See CELLGPRSQOSSETTINGS for more information about this parameter. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	100
  3	200
  4	500
  5	1000
  6	2000
  7	5000
  8	10000
  9	20000
  10	50000
  11	100000
  12	200000
  13	500000
  14	1000000
  15	2000000
  16	5000000
  17	10000000
  18	20000000
  19	50000000
  20	Best Effort

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoQOSPeakThruClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested Quality of Service Profile peak throughput class. See CELLGPRSQOSSETTINGS for more information about this parameter. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	8000
  3	16000
  4	32000
  5	64000
  6	128000
  7	256000
  8	512000
  9	1024000
  10	2048000

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoQOSPrecedenceClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested Quality of Service Profile precedence class. Permitted values are one of the CELLDEVCONFIG_GPRSPRECEDENCECLASS_* values specified in the tsp.h header file. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	High
  3	Normal
  4	Low

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoQOSReliabilityClass
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested Quality of Service Profile reliability class. See CELLGPRSQOSSETTINGS for more information about this parameter. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

  Value	Description
  1	Subscribed
  2	Class 1
  3	Class 2
  4	Class 3
  5	Class 4
  6	Class 5

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• GPRSInfoQOSSettingsValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other Requested Quality of Service parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bRequestedQOSSettingsValid member of the CELLGPRSCONNECTIONINFO structure.

  The following table shows the default settings.

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

• GPRSInfoValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other GPRS parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bGPRSConnectionInfoValid member of the CELLDEVCONFIG structure.

  The following table shows the default settings.

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

• IpAddr
  This parameter is used in the <entryname> characteristic and is placed in the ipaddr member of the RASENTRY structure. This parameter specifies the IP address to be used while this connection is active. This parameter is ignored unless dwfOptions specifies the RASEO_SpecificIpAddr value. For more information about RASENTRY, see MSDN.

  The following table shows the default settings for this parameter.

  Permissions	Read/Write
  Data type	String
  Label	IP address:
  Semantic type	url
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• IpHeaderCompression
  This parameter is used in the <entryname> characteristic to control the setting of the RASEO_IpHeaderCompression member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

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

• NDISGPRSAuthType
  This parameter is used in the <entryname> characteristic to specify the authentication protocol for NDIS based GPRS connection using WWAN. **

  Applies to Windows Mobile 6.5.3

  These values can be displayed on the Security tab of the user interface so the user can select from the available GPRS authentication types. **

  Note

  Only the None, CHAP, and PAP options will be displayed. EAP display is not supported in the user interface.

  The following table lists the possible values.

  Value	Description
  1	None (Default value)
  2	CHAP
  3	PAP
  4	EAP

• Password
  This parameter is used in the <entryname> characteristic and is placed in the szPassword member of the RASDIALPARAMS structure. This parameter specifies the password to be used during authentication. If left empty, the system will optionally automatically prompt for the user name and password when making a connection. This behavior is controlled by the RequirePw parameter. Queries of the Password field will return a string composed of asterisks ('*').

  On operations to set the password, passing in this same string will cause the new password to be ignored and will not change the existing password. For more information about RASDIALPARAMS, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Label	Password:
  Semantic type	alphanumeric-password
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Phone
  This parameter is used in the <entryname> characteristic and is placed in the szLocalPhoneNumber member of the RASENTRY structure. This parameter specifies the local portion of the phone number. This field should not be configured for GPRS connections. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• RadioLinkInfoAckTimer
  This parameter is used in the <entryname>/DevSpecificCellular to be placed in the dwAckTimer member of the CELLRADIOLINKINFO

  See GSM specification 07.07 "6.8 Radio link protocol +CRLP" T1 parameter for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• RadioLinkInfoIws
  This parameter is used in the <entryname>/DevSpecificCellular to be placed in the dwIws member of the CELLRADIOLINKINFO structure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" iws parameter for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• RadioLinkInfoMws
  This parameter is used in the <entryname>/DevSpecificCellular to be placed in the dwMws member of the CELLRADIOLINKINFO structure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" mws parameter for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• RadioLinkInfoResequenceTimer
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify the value to be placed in the dwResequenceTimer member of the CELLRADIOLINKINFO structure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" T4 parameter for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• RadioLinkInfoRetransmitAttempts
  This parameter is used in the <entryname>/DevSpecificCellular to specify the value to be placed in the dwRetransmitAttempts member of the CELLRADIOLINKINFO structure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" N2 parameter for more information.

  The following table shows the default settings:

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator - TPS AuthenticatedUser

• RadioLinkInfoValid
  This parameter is used in the <entryname>/DevSpecificCellular characteristic to specify whether other radio link information parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bRadioLinkInfoValid member of the CELLDEVCONFIG structure.

  The following table shows the default settings.

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

• RadioLinkInfoVersion
  This parameter is used in the <entryname>/DevSpecificCellular to be placed in the dwVersion member of the CELLGPRSQOSSETTINGS structure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" ver parameter for more information.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• ReadOnly
  This parameter is used in the <entryname> characteristic and determines whether users are able to modify GPRS settings. Permitted values are 0 for false and 1 for true. If the value is set to 1, users will be able to view, but not change, the GPRS settings on the device.

  The following table shows the default settings.

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

• RemoteDefaultGateway
  This parameter is used in the <entryname> characteristic and controls the setting of the RASEO_RemoteDefaultGateway member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON.

  The following table shows the default settings.

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

• RequireDataEncryption
  Controls the setting of the RASEO_RequireDataEncryption member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname> characteristic. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

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

• RequireEncryptedPw
  This parameter is used in the <entryname> characteristic to control the setting of the RASEO_RequireEncryptedPw member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

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

• RequireMsEncryptedPw
  This parameter is used in the <entryname> characteristic to control the setting of the RASEO_RequireMsEncryptedPw member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

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

• RequirePw
  This parameter is used in the <entryname> characteristic to control whether the system should prompt for a user name/password/domain name before dialing the phone. If set to 1, the system will prompt if no password or user name is provisioned. If set to 0, the system will not prompt for password before dialing even if no password or user name is provisioned. For GPRS connections, the default value of this parameter is 0.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	Integer
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Script
  This parameter is used in the <entryname> characteristic and is placed in the szScript member of the RASENTRY structure. This parameter specifies a string containing the name of the script file. The file name should be a full path. For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• Secure
  Specifies in the <entryname> characteristic if a connection is more secure. Permitted values are false (not secure) and true (more secure).

  The following table shows the default settings.

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

• SpecificIpAddr
  This parameter is used in the <entryname> characteristic to control the setting of the RASEO_SpecificIpAddr flag in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• SpecificNameServers
  Controls the setting of the RASEO_SpecificNameServers member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname> characteristic. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• SwCompression
  Controls the setting of the RASEO_SwCompression member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname> characteristic. For more information about RASENTRY and the use of this parameter, see MSDN.

  The following table shows the default settings.

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

• UseCountryAndAreaCodes
  Controls the setting of the RASEO_UseCountryAndAreaCodes member in the RASENTRY structure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname> characteristic. For more information about RASENTRY and the use of this parameter, see MSDN.

  Note

  For cellular devices, this parameter is typically ignored, and the system is programmed to dial the full canonical number, for example, "+<country/region code><area code><local number>".

  The following table shows the default settings.

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

• UserName
  Specifies the user name to be used during authentication. If this parameter is empty, based on the RequirePw parameter setting, the system can automatically prompt for the user name and password when making a connection.

  This parameter is used in the <entryname> characteristic and is placed in the szUserName member of the RASDIALPARAMS structure. For more information about RASDIALPARAMS, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

• WinsAddr
  Specifies the IP address of the WINS server to be used while the connection is active. This member is ignored unless dwfOptions specifies the RASEO_SpecificNameServers member.

  For more information about RASENTRY, see MSDN.

  The following table shows the default settings.

  Permissions	Read/Write
  Data type	String
  Roles allowed to query and update setting	Manager Operator TPS AuthenticatedUser

Microsoft Custom Elements

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

Elements	Available
noparm	No
nocharacteristic	Yes
characteristic-query	Yes
parm-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

Tasks

CM_GPRSEntries Configuration Service Provider Examples for OMA Client Provisioning

Concepts

Configuration Service Provider Reference for Windows Mobile Devices