CM_PPPEntries Configuration Service Provider

  • Article

The CM_PPPEntries Configuration Service Provider configures the Point-to-Point Protocol (PPP) entries on the device. Settings for RAS connections are defined in this Configuration Service Provider. GPRS connections are configured using the CM_GPRSEntries connection service provider.

Note Access to this Configuration Service Provider is determined by Security roles. Because OEMs and Mobile Operators can selectively disallow access, ask them about the availability of this Configuration Service Provider. For more information, see Security Roles.

In the root characteristic, the default security roles are defined. The following table shows the default settings.

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

AuthenticatedUser

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 connection service providers.

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

  • <entryname>/DevSpecificUnimodem
    Sets parameters in the device specific structure, which is passed by RAS to the unimodem TAPI device through lineSetDevConfig before initiating the connection. This characteristic is valid only for connections that use the unimodem TAPI service provider.

Parms

  • AltDnsAddr
    This parm is used in the <entryname> characteristic and is placed in the ipaddrDnsAlt 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

    AuthenticatedUser

  • AltWinsAddr
    This parm is 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

    AuthenticatedUser

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

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Area code:
    Semantic type phone-number
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • BearerInfoConnectionElement
    This parm is used in the <entryname>/DevSpecificCellular characteristic and is placed in the dwConnectionElement member of the CELLDEVCONFIG structure. See CELLBEARERINFO for more information about this parm. 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

    AuthenticatedUser

  • BearerInfoService
    This parm is used in the <entryname>/DevSpecificCellular characteristic and 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

    AuthenticatedUser

  • BearerInfoSpeed
    This parm is used in the <entryname>/DevSpecificCellular characteristic and 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

    AuthenticatedUser

  • BearerInfoValid
    This parm 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 associated with the connection (defined in the tsp.h header file).

    The following table shows the default settings.

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

    AuthenticatedUser

  • CompressionInfoDirection
    This parm is used in the <entryname>/DevSpecificCellular characteristic and is placed in the dwDirection member of the CELLDEVCONFIG structure. See CELLDATACOMPINFO for more information about this parm. 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

    AuthenticatedUser

  • CompressionInfoMaxDictEntries
    This parm 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

    AuthenticatedUser

  • CompressionInfoMaxStringLength
    This parm 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

    AuthenticatedUser

  • CompressionInfoRequired
    This parm 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

    AuthenticatedUser

  • CompressionInfoValid
    This parm 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, CELLDATACOMPINFO, CELLGPRSCONNECTIONINFO, and CELLRADIOLINKINFO structures.

    The following table shows the default settings.

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

    AuthenticatedUser

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

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Country code:
    Semantic type phone-number
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • Desc.<langid>
    This parm is used in the <entryname> characteristic. A tag in the format of Desc.<langid> will be used as the language specific identifier for that entry. For example, the field <parm name="Desc.0409" value="PPP Dialup" /> will force "PPP Dialup" to appear in the UI to represent this connection when the device 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 device. 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 parm 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 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

    AuthenticatedUser

  • DeviceName
    This parm is used in the <entryname> characteristic and is placed in the szDeviceName member of the RASENTRY structure. DeviceName specifies the local portion of the phone number. For more information about RASENTRY, see MSDN. This string contains the name of a TAPI device to use with this phone-book entry, for example "XYZ Corp 28800 External". To enumerate the number of available RAS-capable devices, use the lineInitialize function. For Smartphone devices, by default, this field contains the name of the cellular TAPI device (specified in tsp.h) of "Cellular Line".

    The following table shows the default settings.

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

    AuthenticatedUser

  • DeviceSpecificRAW
    This parm 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. It should be used with great caution because it allows direct manipulation of the underlying data structures used by the TAPI service provider. 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.

    The following table shows the default settings.

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

    AuthenticatedUser

  • DeviceType
    This parm is used in the <entryname> characteristic and is placed in the szDeviceType member of the RASENTRY structure. The default value for the szDeviceType is "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

    AuthenticatedUser

  • DialAsLocalCall
    This parm 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 flag, see MSDN.

    Note  For cellular devices, this member is typically ignored, and the system is programmed to dial the full canonical number, for example "+<country 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

    AuthenticatedUser

  • DnsAddr
    This parm is used in the <entryname> characteristic and is placed in the ipaddrDns 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

    AuthenticatedUser

  • Domain
    This parm is used in the <entryname> characteristic and is placed in the szDomain member of the RASDIALPARAMS structure. This parm 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

    AuthenticatedUser

  • Enabled
    This parm can be used in the <entryname> characteristic to enable or disable a connection entry without removing it from the system. The following table lists the possible values.

    Value Description
    0 The connection entry is disabled
    1 The connection entry is enabled

    The following table shows the default settings.

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

    AuthenticatedUser

  • FrameSize
    This parm 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

    AuthenticatedUser

  • Framing
    This parm 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

    AuthenticatedUser

  • GPRSInfoAccessPointName
    This parm 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  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoAddress
    This parm 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoDataCompression
    This parm is used in the <entryname>/DevSpecificCellular characteristic to control PDP data compression. See the CELLGPRSCONNECTIONINFO structureand the GSM specification 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoHeaderCompression
    This parm is used in the <entryname>/DevSpecificCellular characteristic to control PDP header compression. See the CELLGPRSCONNECTIONINFO structureand the See GSM specification 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.

    **Note  **GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoL2ProtocolType
    This parm is used in the <entryname>/DevSpecificCellular characteristic as one of the CELLDEVCONFIG_GPRSL2PROTOCOL_* constants defined in the the CELLGPRSCONNECTIONINFO structure. See GSM specification 07.07 "10.1.6 Enter data state +CGDATA" for more information. The following table lists the possible values.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoMinQOSDelayClass
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile delay class. See CELLGPRSQOSSETTINGS for more information about this parm. 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoMinQOSMeanThruClass
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the Minimum Quality of Service Profile mean throughput class. See CELLGPRSQOSSETTINGS or more information about this parm. 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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 Don't Care

    The following table shows the default settings:

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

    AuthenticatedUser

  • GPRSInfoMinQOSPeakThruClass
    This parm 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 parm. 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoMinQOSPrecedenceClass
    This parm 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoMinQOSReliabilityClass
    This parm 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoMinQOSSettingsValid
    This parm 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 (defined in the tsp.h header file).

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoParameters
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify protocol-specific values when defining a GPRS context. The value 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoProtocolType
    This parm is used in the <entryname>/DevSpecificCellular characteristic as one of the CELLDEVCONFIG_GPRSPROTOCOL_* constants defined in the CELLGPRSCONNECTIONINFO structure. See GSM specification 07.07 "10.1.1 Define PDP Context +CGDCONT" for more information. The following table lists the possible values.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

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

    Note  GPRS parameters are not typically configured for PPP connections.

    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 OEM

    Operator

    Operator - TPS

    Manager

    AuthenticatedUser

  • GPRSInfoQOSMeanThruClass
    This parm 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 parm. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

    Note  GPRS parameters are not typically configured for PPP connections.

    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 Does not apply

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoQOSPeakThruClass
    This parm 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 parm. See GSM specification 07.07 "10.1.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoQOSPrecedenceClass
    This parm 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.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoQOSReliabilityClass
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the Requested 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.2 Quality of Service Profile (Requested) +CGQREQ" for more information. The following table lists the possible values.

    Note  GPRS parameters are not typically configured for PPP connections.

    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

    AuthenticatedUser

  • GPRSInfoQOSSettingsValid
    This parm 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 CELLDEVCONFIG structure associated with the connection (defined in the tsp.h header file).

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

  • GPRSInfoValid
    This parm 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 associated with the connection (defined in the tsp.h header file).

    Note  GPRS parameters are not typically configured for PPP connections.

    The following table shows the default settings.

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

    AuthenticatedUser

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

    The following table shows the default settingsfor this parm.

    Permissions Read/Write
    Data type String
    Label IP address:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • IpHeaderCompression
    This parm 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, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Password
    This parm is used in the <entryname> characteristic and is placed in the szPassword member of the RASDIALPARAMS structure. The Password parm 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. The RequirePw member controls this behavior. Queries of this 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.

    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

    AuthenticatedUser

  • Phone
    This parm is used in the <entryname> characteristic and is placed in the szLocalPhoneNumber member of the RASENTRY structure. The Phone parm specifies the local portion of the phone number. For more information about RASENTRY, see MSDN.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label Phone number:
    Semantic type phone-number
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • RadioLinkInfoAckTimer
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the value to be placed in the dwAckTimer member of the CELLRADIOLINKINFO structure. 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

    AuthenticatedUser

  • RadioLinkInfoIws
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the value 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

    AuthenticatedUser

  • RadioLinkInfoMws
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the value 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

    AuthenticatedUser

  • RadioLinkInfoResequenceTimer
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the value to be placed in the dwResequenceTimer member of the CELLBEARERINFO, CELLDATACOMPINFO, CELLGPRSCONNECTIONINFO, and CELLRADIOLINKINFO structures. 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

    AuthenticatedUser

  • RadioLinkInfoRetransmitAttempts
    This parm is used in the <entryname>/DevSpecificCellular characteristic 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 setting\.

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

    AuthenticatedUser

  • RadioLinkInfoValid
    This parm 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

    AuthenticatedUser

  • RadioLinkInfoVersion
    This parm is used in the <entryname>/DevSpecificCellular characteristic to specify the value to be placed in the dwVersion member of the CELLRADIOLINKINFO 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

    AuthenticatedUser

  • RemoteDefaultGateway
    This parm is used in the <entryname> characteristic to control 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

    AuthenticatedUser

  • RequireDataEncryption
    This parm is used in the <entryname> characteristic to control the setting of the RASEO_RequireDataEncryption 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • RequireEncryptedPw
    This parm 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • RequireMsEncryptedPw
    This parm 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • RequirePw
    This parm 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 a 1, the system will prompt if no password or user name is provisioned. If set to 0, the system will not prompt for a password before dialing even if no password or user name is provisioned. For PPP connections, the default value of this parm is 1.

    The following table shows the default settings.

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

    AuthenticatedUser

  • Script
    This parm is used in the <entryname> characteristic and is placed in the szScript member of the RASENTRY structure. The Script parm 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

    AuthenticatedUser

  • SpecificIpAddr
    This parm is used in the <entryname> characteristic to control the setting of the RASEO_SpecificIpAddr 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • SpecificNameServers
    This parm is used in the <entryname> characteristic to control the setting of the RASEO_SpecificNameServers 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • SwCompression
    This parm is used in the <entryname> characteristic to control the setting of the RASEO_SwCompression 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 flag, see MSDN.

    The following table shows the default settings.

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

    AuthenticatedUser

  • UseCountryAndAreaCodes
    This parm is used in the <entryname> characteristic to control the setting of the RASEO_UseCountryAndAreaCodes 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 flag, see MSDN.

    Note  For cellular devices, this flag is typically ignored, and the system is programmed to dial the full canonical number, for example "+<country 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

    AuthenticatedUser

  • UserName
    This parm is used in the <entryname> characteristic and is placed in the szUserName member of the RASDIALPARAMS structure. The UserName parm specifies the user name to be used during authentication. See PROXY_CONFIG. If the Username parm is left empty, the system will optionally automatically prompt for the user name and password when making a connection. The RequirePw member controls this behavior.

    The following table shows the default settings.

    Permissions Read/Write
    Data type String
    Label User name:
    Roles allowed to query and update setting Manager

    AuthenticatedUser

  • WinsAddr
    This parm is used in the <entryname> characteristic and is placed in the ipaddrWins member of the RASENTRY structure. WinsAddr specifies the IP address of the WINS server to be used while this 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

    AuthenticatedUser

Elements

Elements Available
noparm No
nocharacteristic Yes
characteristic-query Yes
parm-query Yes

For information about specific elements, see MSPROV DTD Elements.

See Also

Configuration Service Provider Reference for Windows Mobile Devices | CM_PPPEntries Configuration Service Provider Examples

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.