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 |
|---|---|
|
La operación se realizó correctamente. |
|
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. |
|
Se requiere un PIN para obtener el texto móvil. |
|
No se inserta una SIM en el dispositivo. |
|
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 |