Método IMbnConnectionContext::SetProvisionedContext (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.

Agrega o actualiza un contexto aprovisionado.

Sintaxis

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

Parámetros

[in] provisionedContexts

Estructura MBN_CONTEXT que especifica el contexto aprovisionado que se va a almacenar en el dispositivo o sim.

[in] providerID

Cadena que representa el identificador del proveedor de red para el que se debe almacenar el contexto aprovisionado. El dispositivo debe devolver el contexto aprovisionado agregado en respuesta a cualquier consulta posterior cuando una SIM con este identificador de proveedor principal está en el dispositivo.

[out] requestID

Identificador de solicitud establecido por el servicio de banda ancha móvil para identificar esta solicitud asincrónica.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_HANDLE	Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_INVALID_ARG	providerID no es válido.

Comentarios

El contextID de provisionedContexts especifica el índice en el dispositivo o la memoria SIM donde se va a almacenar el contexto. Si se establece en MBN_CONTEXT_ID_APPEND, el dispositivo encontrará el índice adecuado para almacenar el contexto.

Se trata de una operación asincrónica y SetProvisionedContext devolverá inmediatamente. Una vez completada la operación, el servicio de banda ancha móvil notificará a la aplicación llamando al método OnSetProvisionedContextComplete de IMbnConnectionContextEvents.

Las adiciones a la lista de contextos aprovisionadas para el identificador del proveedor principal actual no estarán disponibles para realizar consultas hasta que se haya llamado al método OnProvisionedContextListChange de IMbnConnectionContextEvents .

Requisitos

Requisito	Value
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

Consulte también

IMbnConnectionContext