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.
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 cgqsRequestedQOSSettingsis valid.

cgqsRequestedQOSSettings

GPRS Quality of Service (QOS) settings structure. If bRequestedQOSSettingsValidis true, cgqsRequestedQOSSettingsis used; if bRequestedQOSSettingsValidis false, cgqsRequestedQOSSettingsis not used.

bMinimumQOSSettingsValid

TRUE if and only if c gqsMinimumQOSSettingsis valid.

cgqsMinimumQOSSettings

GPRS QOS settings structure. If bMinimumQOSSettingsValidis true, cgqsMinimumQOSSettingsis used; if bMinimumQOSSettingsValidis false, cgqsMinimumQOSSettingsis 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

See Also