OID_WWAN_PROVISIONED_CONTEXTS

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.

Remarks

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.