Método IMbnConnectionContext::GetProvisionedContexts (mbnapi.h)
Importante
A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.
Obtiene una lista de contextos de conexión.
Sintaxis
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
Parámetros
[out, retval] provisionedContexts
Lista de valores de MBN_CONTEXT que representan contextos de conexión almacenados en el dispositivo. Si se produce un error, esta matriz es NULL. Cuando se ejecuta correctamente, la aplicación que realiza la llamada debe liberar la memoria asignada llamando a SafeArrayDestroy.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
Los contextos de conexión no están disponibles. El servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. La aplicación que realiza la llamada puede recibir notificaciones cuando los contextos de conexión están disponibles registrando para el método OnProvisionedContextListChange de IMbnConnectionContextEvents. |
|
Se requiere un PIN para obtener los contextos de conexión. |
|
No se inserta una SIM en el dispositivo. |
|
Se inserta una SIM incorrecta en el dispositivo. |
|
El dispositivo no admite la recuperación de contextos aprovisionados. |
Comentarios
Un contexto de conexión es una abstracción de un conjunto específico de parámetros de configuración de red para configurar un circuito virtual o un flujo sobre la conexión física de banda ancha móvil en la capa 2. En GSM, corresponde al concepto de un contexto PDP; en ADICIONALMENTE, corresponde a un perfil de red.
En algunos casos, los parámetros de conexión ya están disponibles en la memoria del dispositivo o SIM. Este método se puede usar para obtener una lista de contextos de conexión almacenados en el dispositivo para la red del proveedor principal actual.
Solo se deben usar contextos de tipo MBN_CONTEXT_TYPE_INTERNET para realizar conexiones de datos.
Un dispositivo devolverá todos los contextos almacenados del proveedor principal actual. Algunos de los contextos pueden estar vacíos y se notificarán como MBN_CONTEXT_TYPE_NONE.
A veces, la red puede actualizar los contextos aprovisionados almacenados a través de SMS o OTA. Cada vez que haya un cambio en los contextos aprovisionados por el dispositivo, el servicio de banda ancha móvil llamará al método OnProvisionedContextListChange de IMbnConnectionContextEvents. Después, una aplicación puede usar este método para obtener la lista actualizada de contextos aprovisionados.
En el caso de los errores recuperables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED y E_MBN_BAD_SIM, el servicio de banda ancha móvil consultará de nuevo el dispositivo para obtener esta información cuando finalice la condición de error. Por ejemplo, si el dispositivo requiere que se escriba un PIN para recuperar los contextos de conexión, devolverá E_MBN_PIN_REQUIRED. Cuando la aplicación escriba un PIN para desbloquear el dispositivo, el servicio volverá a intentar obtener esta información del dispositivo. El servicio actualizará la aplicación sobre el estado de la nueva consulta llamando al método OnProvisionedContextListChange de IMbnConnectionContextEvents.
Requisitos
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |