Expand Minimize

WWAN_SET_CONTEXT_STATE structure

The WWAN_SET_CONTEXT_STATE structure represents the command to set the Packet Data Protocol (PDP) context state of the MB device.

Syntax


typedef struct _WWAN_SET_CONTEXT_STATE {
  ULONG                   ConnectionId;
  WWAN_ACTIVATION_COMMAND ActivationCommand;
  WCHAR                   AccessString[WWAN_ACCESSSTRING_LEN];
  WCHAR                   UserName[WWAN_USERNAME_LEN];
  WCHAR                   Password[WWAN_PASSWORD_LEN];
  WWAN_COMPRESSION        Compression;
  WWAN_AUTH_PROTOCOL      AuthType;
  WWAN_IP_TYPE            IPType;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;

Members

ConnectionId

MB Service specifies this member to uniquely identify the PDP Context and its corresponding state.

The MB Service uses the value in this member to uniquely identify the current active context across MB network adapters.

The miniport driver must use the value in this member when completing set requests. The MB Service uses the value in this member in subsequent query requests as well as disconnect requests to the miniport driver.

ActivationCommand

Activate or deactivate a PDP context that is referenced in the ConnectionId member. The following table shows the possible values a miniport driver can specify.

ValueMeaning

WwanActivationCommandActivate

Activate PDP context referred to by ConnectionId .

WwanActivationCommandDeactivate

Deactivate a currently activated PDP context referred by ConnectionId .

 

AccessString

A NULL-terminated string to access the network. For GSM-based networks, this would be an Access Point Name (APN) string such as "data.thephone-company.com". For CDMA-based networks, this might be a special dial code such as "#777" or a Network Access Identifier (NAI) such as "foo@thephone-company.com". This member can be NULL.

The size of the string should not exceed 100 bytes.

UserName

A NULL-terminated string that represents the username to authenticate. This member can be NULL.

Password

A NULL-terminated string that represents the username's password. This member can be NULL.

Compression

A value from the WWAN_COMPRESSION enumeration that specifies whether compression should be used in the data connection for header and data. This member applies only to GSM-based devices. The MB Service sets this member to WwanCompressionNone for CDMA-based devices.

ValueMeaning

WwanCompressionNone

No compression is applied.

WwanCompressionEnable

Enable header and data compression.

 

AuthType

A value from the WWAN_AUTH_PROTOCOL enumeration that specifies the authentication type to use for the PDP activation. This member applies only to GSM-based devices. The MB Service sets this member to WwanAuthProtocolNone for CDMA-based devices.

ValueMeaning

WwanAuthProtocolNone

No authentication protocol.

WwanAuthProtocolPap

Unencrypted password authentication.

WwanAuthProtocolChap

Use the Challenge Handshake Authentication Protocol (CHAP).

WwanAuthProtocolMsChapV2

Use the Microsoft Challenge Handshake Authentication Protocol (CHAP) v2.0.

 

IPType

A value from the WWAN_IP_TYPE enumeration that specifies the type of IP.

Requirements

Version

Available in Windows 8 and later versions of Windows.

Header

Wwan.h (include Wwan.h)

See also

WWAN_ACTIVATION_COMMAND
WWAN_COMPRESSION
WWAN_AUTH_PROTOCOL
NDIS_WWAN_SET_CONTEXT_STATE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft