Important: |
---|
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This Configuration Service Provider configures the General Packet Radio Service (GPRS) entries on the device.
Note: |
---|
This Configuration Service Provider is managed using the OMA Client Provisioning (formerly WAP Client Provisioning) protocol. To provision devices using the OMA DM protocol, use the NAP Configuration Service Providerinstead. 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 Rolesand Default Roles for Configuration Service Providers. |
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 lineSetDevConfigparameter 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 lineSetDevConfigparameter 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 ipaddrDnsAltmember of the RASENTRYstructure. For more information about RASENTRY, see MSDN.
Note: Once configured, the AltDnsAddrparameter 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 ipaddrWinsAltmember of the RASENTRYstructure. 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 szAreaCodemember of the RASENTRYstructure. 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>/DevSpecificCellularcharacteristic. This parameter is placed in the dwConnectionElementmember of the CELLDEVCONFIGstructure.
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>/DevSpecificCellularcharacteristic. The parameter is placed in the dwServicemember of the CELLDEVCONFIGstructure. 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>/DevSpecificCellularcharacteristic. The parameter is placed in the dwSpeedmember of the CELLDEVCONFIGstructure. 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>/DevSpecificCellularcharacteristic 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 bBearerInfoValidmember of the CELLDEVCONFIGstructure.
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>/DevSpecificCellularcharacteristic. The parameter is placed in the dwDirectionmember of the CELLDEVCONFIGstructure.
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>/DevSpecificCellularcharacteristic to control the maximum number of dictionary entries for V.42bis data compression. The value is placed in the dwMaxDictEntriesmember of the CELLDEVCONFIGstructure.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>/DevSpecificCellularcharacteristic to control the maximum string length for V.42bis data compression. The value is placed in the dwMaxStringLengthmember of the CELLDEVCONFIGstructure.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>/DevSpecificCellularcharacteristic to specify whether data compression is required. Permitted values are 0 for OFF or 1 for ON. This value is placed in the dwRequiredmember of the CELLDEVCONFIGstructure. 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>/DevSpecificCellularcharacteristic 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 bDataCompInfoValidmember of the CELLDEVCONFIGstructure.
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 dwCountryCodemember of the RASENTRYstructure. 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 < parmname="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 Desctag 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 szDeviceNamemember of the RASENTRYstructure, 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 lineInitializefunction. 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 DevSpecificCellularand DevSpecificUnimodemcharacteristics, 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 lineSetDevConfigeach 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 szDeviceTypemember of the RASENTRYstructure. 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_DialAsLocalCallmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRYand 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 ipaddrDnsmember of the RASENTRYstructure. For more information about RASENTRY, see MSDN.
Note: Once configured, the DnsAddrparameter 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 szDomainmember of the RASDIALPARAMSstructure. 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 dwFrameSizemember of the RASENTRYstructure. 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 dwFramingProtocolmember of the RASENTRYstructure. 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>/DevSpecificCellularcharacteristic to specify the logical name to select the GPRS gateway. The value is placed in the wszAccessPointNamemember of the CELLGPRSCONNECTIONINFOstructure.
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>/DevSpecificCellularcharacteristic to specify the packet address to use on the connection. The value is placed in the wszAddressmember of the CELLGPRSCONNECTIONINFOstructure.
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>/DevSpecificCellularcharacteristic to control PDP data compression. See CELLGPRSCONNECTIONINFOand 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>/DevSpecificCellularcharacteristic to control PDP header compression. See CELLGPRSCONNECTIONINFOand 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>/DevSpecificCellularcharacteristic to specify the protocol for level 2 information transmission. See CELLGPRSCONNECTIONINFOfor 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>/DevSpecificCellularcharacteristic 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>/DevSpecificCellularcharacteristic to specify the Minimum Quality of Service Profile mean throughput class. See CELLGPRSQOSSETTINGSin 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>/DevSpecificCellularcharacteristic to specify the Minimum Quality of Service Profile peak throughput class. See CELLGPRSQOSSETTINGSfor 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>/DevSpecificCellularcharacteristic 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>/DevSpecificCellularcharacteristic 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>/DevSpecificCellularcharacteristic 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 bMinimumQOSSettingsValidmember of the CELLGPRSCONNECTIONINFOstructure 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>/DevSpecificCellularcharacteristic for specifying Protocol-specific values when defining a GPRS context. This parameter specifies a text string that is placed in the szParametersmember of the CELLGPRSCONNECTIONINFOstructure.
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>/DevSpecificCellularcharacteristic. See CELLGPRSCONNECTIONINFOfor 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>/DevSpecificCellularcharacteristic to specify the Requested Quality of Service Profile delay class. See CELLGPRSQOSSETTINGSfor 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>/DevSpecificCellularcharacteristic to specify the Requested Quality of Service Profile mean throughput class. See CELLGPRSQOSSETTINGSfor 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>/DevSpecificCellularcharacteristic to specify the Requested Quality of Service Profile peak throughput class. See CELLGPRSQOSSETTINGSfor 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>/DevSpecificCellularcharacteristic 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>/DevSpecificCellularcharacteristic to specify the Requested Quality of Service Profile reliability class. See CELLGPRSQOSSETTINGSfor 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>/DevSpecificCellularcharacteristic 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 bRequestedQOSSettingsValidmember of the CELLGPRSCONNECTIONINFOstructure.
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>/DevSpecificCellularcharacteristic to specify whether other GPRS parameters are valid. Permitted values are 0 for OFF or 1 for ON. The value is placed in the bGPRSConnectionInfoValidmember of the CELLDEVCONFIGstructure.
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 ipaddrmember of the RASENTRYstructure. This parameter specifies the IP address to be used while this connection is active. This parameter is ignored unless dwfOptionsspecifies 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_IpHeaderCompressionmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRYand 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 szPasswordmember of the RASDIALPARAMSstructure. 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 RequirePwparameter. Queries of the Passwordfield 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 szLocalPhoneNumbermember of the RASENTRYstructure. 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>/DevSpecificCellularto be placed in the dwAckTimermember 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>/DevSpecificCellularto be placed in the dwIwsmember of the CELLRADIOLINKINFOstructure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" iwsparameter 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>/DevSpecificCellularto be placed in the dwMwsmember of the CELLRADIOLINKINFOstructure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" mwsparameter 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>/DevSpecificCellularcharacteristic to specify the value to be placed in the dwResequenceTimermember of the CELLRADIOLINKINFOstructure. 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>/DevSpecificCellularto specify the value to be placed in the dwRetransmitAttemptsmember of the CELLRADIOLINKINFOstructure. 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>/DevSpecificCellularcharacteristic 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 bRadioLinkInfoValidmember of the CELLDEVCONFIGstructure.
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>/DevSpecificCellularto be placed in the dwVersionmember of the CELLGPRSQOSSETTINGSstructure. See GSM specification 07.07 "6.8 Radio link protocol +CRLP" verparameter 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_RemoteDefaultGatewaymember in the RASENTRYstructure. 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_RequireDataEncryptionmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname>characteristic. For more information about RASENTRYand 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_RequireEncryptedPwmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRYand 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_RequireMsEncryptedPwmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRYand 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 szScriptmember of the RASENTRYstructure. 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_SpecificIpAddrflag in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. For more information about RASENTRYand 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_SpecificNameServersmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname>characteristic. For more information about RASENTRYand 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_SwCompressionmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname>characteristic. For more information about RASENTRYand 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_UseCountryAndAreaCodesmember in the RASENTRYstructure. Permitted values are 0 for OFF or 1 for ON. This parameter is used in the <entryname>characteristic. For more information about RASENTRYand 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 RequirePwparameter 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 szUserNamemember of the RASDIALPARAMSstructure. 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 dwfOptionsspecifies the RASEO_SpecificNameServersmember.
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.