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
S_OK	El método se completó correctamente. homeProvider contiene valores válidos.
E_PENDING	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.
E_MBN_PIN_REQUIRED	El dispositivo requiere que se escriba un PIN para esta operación.
E_MBN_SIM_NOT_INSERTED	No se inserta la SIM.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.
HRESULT_FROM_WIN32(ERROR_READ_FAULT)	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

Consulte también

IMbnInterface