WWAN_SET_CONTEXT_STATE 结构 (wwan.h)
WWAN_SET_CONTEXT_STATE 结构表示用于将数据包数据协议 (PDP) MB 设备的上下文状态设置的命令。
语法
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_PSMEDIA_PREFERENCE MediaPreference;
WWAN_CONFIGURATION_SOURCE ConnectionMediaSource;
WWAN_ACTIVATION_OPTION ActivationOption;
WWAN_SINGLE_NSSAI Snssai;
WWAN_OFFSET_SIZE_ELEMENT TrafficParameters;
} WWAN_SET_CONTEXT_STATE, *PWWAN_SET_CONTEXT_STATE;
成员
ConnectionId
MB 服务指定此成员以唯一标识 PDP 上下文及其相应状态。
MB 服务使用此成员中的 值跨 MB 网络适配器唯一标识当前活动上下文。
完成 设置 请求时，微型端口驱动程序必须使用此成员中的 值。 MB 服务在后续 查询 请求中使用此成员中的值，并断开对微型端口驱动程序的请求的连接。
ActivationCommand
激活或停用 ConnectionId 成员中引用的 PDP 上下文。 下表显示了微型端口驱动程序可以指定的可能值。
| 值 | 含义 |
|---|---|
| WwanActivationCommandActivate | 激活 ConnectionId 引用的 PDP 上下文。 |
| WwanActivationCommandDeactivate | 停用 由 ConnectionId 引用的当前激活的 PDP 上下文。 |
AccessString[WWAN_ACCESSSTRING_LEN]
一个以 NULL 结尾的字符串，用于访问网络。 对于基于 GSM 的网络，这将是接入点名称 (APN) 字符串（例如“data.thephone-company.com”。 对于基于 CDMA 的网络，这可能是特殊拨号代码（例如“#777”）或网络访问标识符 (NAI) ，例如“”。foo@thephone-company.com 此成员可以为 NULL。
字符串的大小不应超过 100 个字节。
UserName[WWAN_USERNAME_LEN]
以 NULL 结尾的字符串，表示要进行身份验证的用户名。 此成员可以为 NULL。
Password[WWAN_PASSWORD_LEN]
一个以 NULL 结尾的字符串，表示用户名的密码。 此成员可以为 NULL。
Compression
WWAN_COMPRESSION 枚举中的一个值，该值指定是否应在标头和数据的数据连接中使用压缩。 此成员仅适用于基于 GSM 的设备。 对于基于 CDMA 的设备，MB 服务将此成员设置为 WwanCompressionNone 。
| 值 | 含义 |
|---|---|
| WwanCompressionNone | 不应用任何压缩。 |
| WwanCompressionEnable | 启用标头和数据压缩。 |
AuthType
WWAN_AUTH_PROTOCOL 枚举中的值，该值指定要用于 PDP 激活的身份验证类型。 此成员仅适用于基于 GSM 的设备。 对于基于 CDMA 的设备，MB 服务将此成员设置为 WwanAuthProtocolNone 。
| 值 | 含义 |
|---|---|
| WwanAuthProtocolNone | 无身份验证协议。 |
| WwanAuthProtocolPap | 未加密的密码身份验证。 |
| WwanAuthProtocolChap | 使用质询握手身份验证协议 (CHAP) 。 |
| WwanAuthProtocolMsChapV2 | 使用 Microsoft 质询握手身份验证协议 (CHAP) v2.0。 |
IPType
WWAN_IP_TYPE枚举中的值，该值指定 IP 的类型。
MediaPreference
ConnectionMediaSource
ActivationOption
WWAN_ACTIVATION_OPTION 枚举中的值，表示 MB 设备支持的数据包数据协议 (PDP) 激活选项。
Snssai
表示单个网络切片选择帮助信息 ( NSSAI) 的WWAN_SINGLE_NSSAI结构。
TrafficParameters
WWAN_OFFSET_SIZE_ELEMENT结构。 前 4 个字节是 DataBuffer 的偏移量，其中包含MBIM_TLV_TYPE_TRAFFIC_PARAMETERS数据字段的原始数据（以字节为单位），从WWAN_SET_CONTEXT_STATE开始计算。 第二个 4 个字节是MBIM_TLV_TYPE_TRAFFIC_PARAMETERS数据字段的原始数据的大小（以字节为单位）。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 适用于 Windows 8 及更高版本的 Windows。 |
| 标头 | wwan.h (包括 Wwan.h) |