OID_WWAN_PROVISIONED_CONTEXTS reads or updates the provisioned context entries stored on the MB device or the Subscriber Identity Module (SIM).
Miniport drivers must process set and query requests asynchronously, initially returning NDIS_STATUS_INDICATION_REQUIRED to the original request, and later sending an NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS status notification containing an NDIS_WWAN_PROVISIONED_CONTEXTS structure to provide information about provisioned context entries stored on the MB device or the Subscriber Identity Module (SIM) regardless of completing set or query requests.
For more information about using this OID, see WWAN Packet Context Management.
Miniport drivers should return NDIS_STATUS_NOT_SUPPORTED if the MB device they support does not support retrieval of provisioned contexts.
GSM-based devices can optionally support query and set operations. CDMA-based devices can optionally support query operations reporting Simple IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
The provisioned context entries stored on the MB device or the SIM are local to the device. Miniport drivers should not connect to the network to read in these fields.
The input structure for a set request is NDIS_WWAN_SET_PROVISIONED_CONTEXT and status indication of this object is NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Provisioned contexts are not same as that of the GPRS context definitions in 3GPP that caches the list of APNs. Provisioned contexts are the connectivity parameters (AccessString, UserName, and Password) that are either pre-provisioned by the Operators or OTA provisioned by the device and can be stored either in the device memory or SIM. The connectivity parameters returned by the Provisioned contexts will be used by the MB Service for PDP activation.
Both query and set form of this object is used.
Processing of this request does not require network access, but requires access to the SIM or auxiliary memory on the MB device.
The miniport driver sends NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS notification to the operating system. The ContextListHeader.ElementType member shall be set to WwanStructContext. Miniport driver should set the ContextListHeader.ElementCount member to 0 when notification is sent in response to a set request.
The MB Service should retrieve the list of provisioned contexts from the device before conducting any individual context activation or deactivation. The list of provisioned contexts must be restricted only to the home provider network even though the device may have the capability to store multiple network provider contexts. The context list must always be the home provider network specific even in case of roaming.
SET OID_WWAN_PROVISIONED_CONTEXT operation should associate the context with the network provider that is specified in the set request in ProviderId member of the WWAN_SET_CONTEXT structure. Provisioned context stored through set OID_WWAN_PROVISIONED_CONTEXT requests must persist across system restarts and device power recycles.
All the empty contexts need to be reported on a query along with the provisioned contexts applicable to the home provider network.
CDMA devices that are configured for SimpleIP, reporting in WWAN_CTRL_CAPS_CDMA_SIMPLE_IP in WwanControlCaps can optionally return at least one provisioned context filled with the correct AccessString, UserName, and Password members for the query request from MB Service.
Provisioned context list should be pre-provisioned in the device, updated by set OID_WWAN_PROVISIONED_CONTEXT operations, or updated by device/operator using SMS or OTA. It must not be updated dynamically based on the context information provided in the OID_WWAN_CONNECT operation by MB Service.
For more information about how to access AccessString, UserName, and Password from the MB device for each provisioned context in the list, see WWAN_CONTEXT.
|Available in Windows 7 and later versions of Windows.|