OID_WWAN_PROVISIONED_CONTEXTS

OID_WWAN_PROVISIONED_CONTEXTS读取或更新存储在 MB 设备或订阅服务器标识模块 (SIM) 上的预配上下文条目。

微型端口驱动程序必须异步处理设置和查询请求，最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求，然后发送包含 NDIS_WWAN_PROVISIONED_CONTEXTS 结构的 NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS 状态通知，以提供有关存储在 MB 设备或订阅者标识模块 (SIM) 的预配上下文条目的信息，而不考虑完成集或查询请求。

注解

有关使用此 OID 的详细信息，请参阅 WWAN 数据包上下文管理。

如果微型端口驱动程序支持的 MB 设备不支持检索预配的上下文，则微型端口驱动程序应返回NDIS_STATUS_NOT_SUPPORTED。

基于 GSM 的设备可以选择性地支持查询和设置操作。 基于 CDMA 的设备可以选择性地支持报告简单 IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) 的查询操作。

存储在 MB 设备或 SIM 卡上的预配上下文条目是设备的本地项。 微型端口驱动程序不应连接到网络来读取这些字段。

设置请求的输入结构是NDIS_WWAN_SET_PROVISIONED_CONTEXT，并且此对象的状态指示是NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS。

预配的上下文与缓存 APN 列表的 3GPP 中的 GPRS 上下文定义不同。 预配上下文是 AccessString、UserName 和 Password) (连接参数，这些参数由操作员预先预配或设备预配的 OTA，可以存储在设备内存或 SIM 中。 预配上下文返回的连接参数将由 MB 服务用于 PDP 激活。

同时使用此对象的查询和设置形式。

处理此请求不需要网络访问权限，但需要访问 MB 设备上的 SIM 卡或辅助内存。

微型端口驱动程序将NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS通知发送到操作系统。 ContextListHeader.ElementType 成员应设置为 WwanStructContext。 当发送通知以响应设置请求时，微型端口驱动程序应将 ContextListHeader.ElementCount 成员设置为 0。

MB 服务应在执行任何单个上下文激活或停用之前从设备检索预配的上下文列表。 预配的上下文列表必须仅限于主提供商网络，即使设备可能能够存储多个网络提供程序上下文。 上下文列表必须始终是特定于主提供商网络，即使在漫游的情况下也是如此。

SET OID_WWAN_PROVISIONED_CONTEXT操作应将上下文与WWAN_SET_CONTEXT结构的 ProviderId 成员中的设置请求中指定的网络提供程序相关联。 通过设置OID_WWAN_PROVISIONED_CONTEXT请求存储的预配上下文必须在系统重启和设备电源回收之间持久保存。

需要针对查询报告所有空上下文以及适用于主提供商网络的预配上下文。

为 WwanControlCaps 中的 WWAN_CTRL_CAPS_CDMA_SIMPLE_IP 报告为 SimpleIP 配置的 CDMA 设备可以选择性地返回至少一个预配的上下文，其中填充了来自 MB 服务的查询请求的正确 AccessString、 UserName 和 Password 成员。

预配的上下文列表应在设备中预先预配，通过设置OID_WWAN_PROVISIONED_CONTEXT操作进行更新，或者由设备/操作员使用短信或 OTA 进行更新。 不得根据 MB 服务OID_WWAN_CONNECT操作中提供的上下文信息动态更新它。

有关如何从 MB 设备访问列表中每个预配上下文的 AccessString、UserName 和 Password 的详细信息，请参阅 WWAN_CONTEXT。

要求

版本	在 Windows 7 和更高版本的 Windows 中可用。
标头	Ntddndis.h (包括 Ndis.h)

另请参阅

WWAN 数据包上下文管理