OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_PROVISIONED_CONTEXTS lee o actualiza las entradas de contexto aprovisionadas almacenadas en el dispositivo MB o en el módulo de identidad de suscriptor (SIM).
Los controladores de minipuerto deben procesar las solicitudes de establecimiento y consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado de NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS que contiene una estructura de NDIS_WWAN_PROVISIONED_CONTEXTS para proporcionar información sobre las entradas de contexto aprovisionadas almacenadas en el dispositivo MB o el Módulo de identidad de suscriptor (SIM) independientemente de completar las solicitudes de conjunto o consulta.
Observaciones
Para obtener más información sobre el uso de este OID, vea WWAN Packet Context Management.
Los controladores de minipuerto deben devolver NDIS_STATUS_NOT_SUPPORTED si el dispositivo MB que admite no admite la recuperación de contextos aprovisionados.
Los dispositivos basados en GSM pueden admitir opcionalmente las operaciones de consulta y establecimiento. Los dispositivos basados en XAML pueden admitir opcionalmente operaciones de consulta que notifican ip simple (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).
Las entradas de contexto aprovisionadas almacenadas en el dispositivo MB o la SIM son locales para el dispositivo. Los controladores de minipuerto no deben conectarse a la red para leer en estos campos.
La estructura de entrada de una solicitud de conjunto es NDIS_WWAN_SET_PROVISIONED_CONTEXT y la indicación de estado de este objeto es NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS.
Los contextos aprovisionados no son los mismos que los de las definiciones de contexto gpRS en 3GPP que almacenan en caché la lista de APN. Los contextos aprovisionados son los parámetros de conectividad (AccessString, UserName y Password) que están aprovisionados previamente por los operadores o OTA aprovisionados por el dispositivo y se pueden almacenar en la memoria del dispositivo o en la SIM. El servicio MB usará los parámetros de conectividad devueltos por los contextos aprovisionados para la activación de PDP.
Se usa tanto la consulta como la forma de conjunto de este objeto.
El procesamiento de esta solicitud no requiere acceso a la red, pero requiere acceso a la MEMORIA SIM o auxiliar en el dispositivo MB.
El controlador de minipuerto envía NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS notificación al sistema operativo. El miembro ContextListHeader.ElementType se establecerá en WwanStructContext. El controlador Miniport debe establecer el miembro ContextListHeader.ElementCount en 0 cuando se envía la notificación en respuesta a una solicitud establecida.
El servicio MB debe recuperar la lista de contextos aprovisionados del dispositivo antes de realizar cualquier activación o desactivación de contexto individual. La lista de contextos aprovisionados solo debe restringirse a la red del proveedor principal, aunque el dispositivo pueda tener la capacidad de almacenar varios contextos de proveedor de red. La lista de contexto siempre debe ser específica de la red del proveedor principal, incluso en el caso de itinerancia.
SET OID_WWAN_PROVISIONED_CONTEXT operación debe asociar el contexto con el proveedor de red especificado en la solicitud set en el miembro ProviderId de la estructura WWAN_SET_CONTEXT. El contexto aprovisionado almacenado mediante el conjunto de solicitudes OID_WWAN_PROVISIONED_CONTEXT debe conservarse en los reinicios del sistema y los reciclajes de energía del dispositivo.
Todos los contextos vacíos deben notificarse en una consulta junto con los contextos aprovisionados aplicables a la red del proveedor principal.
Los dispositivos NAME configurados para SimpleIP, los informes en WWAN_CTRL_CAPS_CDMA_SIMPLE_IP en WwanControlCaps pueden devolver opcionalmente al menos un contexto aprovisionado rellenado con los miembros AccessString, UserName y Password correctos para la solicitud de consulta del servicio MB.
La lista de contextos aprovisionadas debe aprovisionarse previamente en el dispositivo, actualizarse mediante el establecimiento de operaciones de OID_WWAN_PROVISIONED_CONTEXT o actualizadas por el dispositivo o operador mediante SMS o OTA. No se debe actualizar dinámicamente en función de la información de contexto proporcionada en la operación de OID_WWAN_CONNECT por el servicio MB.
Para obtener más información sobre cómo acceder a AccessString, UserName y Password desde el dispositivo MB para cada contexto aprovisionado de la lista, consulte WWAN_CONTEXT.
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |