Método IMbnMultiCarrier::SetHomeProvider (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.
Novedades el proveedor principal para un dispositivo de varios operadores.
Sintaxis
HRESULT SetHomeProvider(
[in] MBN_PROVIDER2 *homeProvider,
[out] ULONG *requestID
);
Parámetros
[in] homeProvider
Estructura MBN_PROVIDER2 que contiene el proveedor principal.
Los miembros SignalStrength y SignalError deben ser 0.
[out] requestID
Puntero al identificador de solicitud establecido por el sistema operativo para esta solicitud. La respuesta asincrónica de OnSetHomeProviderComplete contendrá este mismo requestID.
Puntero al identificador de solicitud establecido por el sistema operativo para esta solicitud. La respuesta asincrónica contendrá este mismo requestID.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. |
|
El servicio de banda ancha móvil no se está ejecutando en este sistema. |
|
Interfaz no válida. Es probable que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
El dispositivo no admite la operación. Los dispositivos que no admiten varios operadores pueden devolverlo. |
Comentarios
El método SetHomeProvider inicia una actualización del proveedor principal para la interfaz. Se trata de una operación asincrónica y la llamada al método devuelve inmediatamente. Si este método devuelve correctamente con S_OK, Windows notificará a la aplicación que realiza la llamada sobre el estado de finalización de esta operación llamando al método OnSetHomeProviderComplete de IMbnMultiCarrierEvents.
A continuación, el dispositivo aparecerá registrado automáticamente en la nueva red e indicará un cambio de estado de registro. El dispositivo seguirá estando registrado en esta nueva red doméstica a través de los reinicios de Windows a menos que SetHomeProvider se use de nuevo para establecer un nuevo proveedor principal.
Si el dispositivo se quita del sistema antes de que se complete esta operación, no hay ninguna garantía de que la aplicación que realiza la llamada recibirá la notificación de finalización.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |