CELLGPRSCONNECTIONINFO

This structure contains General Packet Radio Service (GPRS) connection information that is used in the initiation of GPRS calls. Use this structure to specify the parameters of a GPRS connection.

typedef struct cellgprsconnectioninfo_tag {
DWORD dwProtocolType;
DWORD dwL2ProtocolType
WCHAR wszAccessPointName[CELLDEVCONFIG_MAXLENGTH_GPRSACCESSPOINTNAME];
WCHAR wszAddress[CELLDEVCONFIG_MAXLENGTH_GPRSADDRESS];
DWORD dwDataCompression;
DWORD dwHeaderCompression;
char szParameters[CELLDEVCONFIG_MAXLENGTH_GPRSPARAMETERS];
BOOL bRequestedQOSSettingsValid;
CELLGPRSQOSSETTINGS cgqsRequestedQOSSettings;
BOOL bMinimumQOSSettingsValid;
CELLGPRSQOSSETTINGS cgqsMinimumQOSSettings;
} CELLGPRSCONNECTIONINFO, *LPCELLGPRSCONNECTIONINFO;

Members

  • dwProtocolType
    Identifies the protocol type for the GPRS connection. May be one of the values listed in the following table.

    Value Description
    CELLDEVCONFIG_GPRSPROTOCOL_
    UNKNOWN
    Unknown protocol type.
    CELLDEVCONFIG_GPRSPROTOCOL_X25 Unsupported protocol type.
    CELLDEVCONFIG_GPRSPROTOCOL_IP Internet provider protocol type. Radio acts as a Point-to-Point protocol (PPP) server.
    CELLDEVCONFIG_GPRSPROTOCOL_IHOSP Unsupported protocol type.
    CELLDEVCONFIG_GPRSPROTOCOL_PPP Point-to-Point protocol (PPP). Frames are forwarded to the end server.
  • dwL2ProtocolType
    Identifies the level-2 protocol type for the GPRS connection. May be one of the values listed in the following table.

    Value Description
    CELLDEVCONFIG_GPRSL2PROTOCOL_
    UNKNOWN
    Unknown protocol type.
    CELLDEVCONFIG_GPRSL2PROTOCOL_NULL Unsupported protocol type.
    CELLDEVCONFIG_GPRSL2PROTOCOL_PPP Microsoft® Windows® CE uses Point-to-Point protocol (PPP).
    CELLDEVCONFIG_GPRSL2PROTOCOL_PAD Unsupported protocol type.
    CELLDEVCONFIG_GPRSL2PROTOCOL_X25 Unsupported protocol type.
  • wszAccessPointName
    Specifies the logical name to select the GPRS gateway.

  • wszAddress
    Specifies the packet address to use for the connection. If this string is empty, then a dynamic address will be requested.

  • dwDataCompression
    Identifies the data compression setting for messages that are sent and received. May be one of the values listed in the following table.

    Value Description
    CELLDEVCONFIG_GPRSCOMPRESSION_
    UNKNOWN
    Compression is unknown.
    CELLDEVCONFIG_GPRSCOMPRESSION_OFF Compression is turned off.
    CELLDEVCONFIG_GPRSCOMPRESSION_ON Compression is turned on.
  • dwHeaderCompression
    Identifies the data compression setting for messages that are sent and received. For a list of possible values, see the list of values for dwDataCompression.

  • szParameters
    Identifies protocol-specific parameters. Must be NULL terminated.

  • bRequestedQOSSettingsValid
    TRUE if and only if cgqsRequestedQOSSettings is valid.

  • cgqsRequestedQOSSettings
    GPRS Quality of Service (QOS) settings structure. If bRequestedQOSSettingsValid is true, cgqsRequestedQOSSettings is used; if bRequestedQOSSettingsValid is false, cgqsRequestedQOSSettings is not used.

  • bMinimumQOSSettingsValid
    TRUE if and only if cgqsMinimumQOSSettings is valid.

  • cgqsMinimumQOSSettings
    GPRS QOS settings structure. If bMinimumQOSSettingsValid is true, cgqsMinimumQOSSettings is used; if bMinimumQOSSettingsValid is false, cgqsMinimumQOSSettings is not used.

Remarks

This is used to specify a particular GPRS connection profile. To establish a connection, the characters in the GPRS_DEST_ADDRESS string must be a subset of the dial string passed to lineMakeCall. This will initiate a GPRS connection, applying the parameters in this structure. This dial string workaround allows applications to have more complete control over the GPRS parameters used for their connection.

Requirements

Smartphone Platforms: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: tsp.h
Library: cellcore.lib

See Also

CELLDEVCONFIG

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.