CELLGPRSCONNECTIONINFO
A version of this page is also available for
4/8/2010
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.
Syntax
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
Windows Embedded 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
| Header | tsp.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2002 and later, Smartphone 2002 and later |