Método IMbnInterface::GetHomeProvider (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 el proveedor principal.
Sintaxis
HRESULT GetHomeProvider(
[out, retval] MBN_PROVIDER *homeProvider
);
Parámetros
[out, retval] homeProvider
Puntero a una estructura de MBN_PROVIDER que representa el proveedor principal. Si este método devuelve cualquier valor distinto de S_OK, este parámetro es NULL. Tras la finalización, la aplicación que realiza la llamada debe liberar la memoria asignada a los miembros providerID y providerName de MBN_PROVIDER mediante una llamada a SysFreeString.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
El método se completó correctamente. homeProvider contiene valores válidos. |
|
La información no está disponible. El servicio de banda ancha móvil está sondeando actualmente para obtener el proveedor doméstico. La aplicación que realiza la llamada puede recibir notificaciones cuando el proveedor principal esté disponible registrando el método OnHomeProviderAvailable de IMbnInterfaceEvents. |
|
El dispositivo requiere que se escriba un PIN para esta operación. |
|
No se inserta la SIM. |
|
Se inserta una SIM incorrecta en el dispositivo. |
|
No se puede leer desde la memoria sim o del dispositivo. Por ejemplo, la SIM no tiene aprovisionada la información del proveedor principal. |
Comentarios
GetHomeProvider devuelve la información del proveedor principal del dispositivo. Se debe omitir el campo dataClass de la estructura de MBN_PROVIDER devuelta.
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á el dispositivo de nuevo para el proveedor principal cuando se supere la condición de error. Por ejemplo, si el dispositivo requiere que se escriba un PIN para recuperar esta información, devolverá E_MBN_PIN_REQUIRED. Cuando la aplicación entra en el PIN para desbloquear el dispositivo, el servicio de banda ancha móvil volverá a intentar obtener esta información del dispositivo. El sistema actualizará la aplicación sobre el estado de la nueva consulta llamando al método OnHomeProviderAvailable de IMbnInterfaceEvents.
Se puede llamar al método OnHomeProviderAvailable registrado de IMbnInterfaceEvents cuando la información del proveedor principal está disponible o la nueva consulta se completó con un error. Una vez que esta función devuelve éxito, esta información nunca cambiará.
Requisitos
| Cliente mínimo compatible | Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |