Método IMbnRegistration::GetRoamingText (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 texto móvil que describe el proveedor de itinerancia.

Sintaxis

HRESULT GetRoamingText(
  [out] BSTR *roamingText
);

Parámetros

[out] roamingText

Puntero a una cadena que contiene información adicional sobre una red con la que el dispositivo está en itinerancia. La longitud máxima es MBN_ROAMTEXT_LEN caracteres. La cadena solo se rellena cuando el método devuelve S_OK para que se realice correctamente. Tras el éxito, la aplicación que realiza la llamada debe liberar la memoria asignada mediante una llamada a SysFreeString.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_PENDING	El texto móvil no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. Cuando el texto móvil esté disponible, el servicio de banda ancha móvil llamará al método OnRegisterModeAvailable de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED	Se requiere un PIN para obtener el texto móvil.
E_MBN_SIM_NOT_INSERTED	No se inserta una SIM en el dispositivo.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.

Comentarios

El método GetRoamingText puede obtener una cadena de texto que contenga información adicional sobre la red cuando el estado de registro sea MBN_REGISTER_STATE_PARTNER o MBN_REGISTER_STATE_ROAMING.

Esta información puede cambiar cuando el dispositivo de banda ancha móvil se mueve de una red a otra. Esto incluye cada vez que hay un cambio de MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING en el estado de registro de red. Esto también ocurre cuando hay un cambio en la red registrada, como cuando una red mueve su registro de un proveedor a otro. Después de estos cambios, el servicio de banda ancha móvil llamará al método OnRegisterStateChange de IMbnRegistrationEvents.

Para el error recuperable E_MBN_PIN_REQUIRED, el servicio de banda ancha móvil volverá a intentar capturar esta información del dispositivo cuando se supere la condición de error (cuando se escribe un PIN). A continuación, llamará al método OnRegisterStateChange de IMbnRegistrationEvents.

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

IMbnRegistration