Share via

CELLGPRSCONNECTIONINFO

Send Feedback

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

Pocket PC: Pocket PC 2002 and later
Smartphone: 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

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.

  • Last updated on