Compartir a través de

Método IMbnRegistration::GetRegisterState (mbnapi.h)

  • Artículo

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 estado de registro.

Sintaxis

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

Parámetros

[out] registerState

Puntero MBN_REGISTER_STATE valor que especifica el estado de registro actual del dispositivo. El valor solo es significativo si el método devuelto S_OK.

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 estado de registro no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. Cuando el estado de registro esté disponible, el servicio de banda ancha móvil llamará al método OnRegisterStateChange de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
 Se requiere un PIN para obtener el estado de registro.

Comentarios

El método GetRegisterState obtiene el estado de registro de red actual del dispositivo. El dispositivo se puede registrar en una red, buscar en la red para el registro o se puede denegar el registro.

El estado de registro del dispositivo puede cambiar automáticamente. Por ejemplo, cuando el dispositivo sale del área de cobertura de red, cambia el estado de registro de MBN_REGISTER_STATE_HOME a MBN_REGISTER_STATE_SEARCHING.

Una aplicación puede registrarse para recibir actualizaciones de cambios de estado de registro mediante la conexión de la interfaz IMbnRegistrationEvents . Windows llamará al método OnRegisterStateChange de IMbnRegistrationEvents para notificar a la aplicación sobre estos cambios.

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