Compartir a través de

Método IMbnInterface::GetReadyState (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 listo.

Sintaxis

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

Parámetros

[out, retval] readyState

Puntero a una estructura de MBN_READY_STATE . Si este método devuelve cualquier valor distinto de S_OK, este parámetro es NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente. readyState contiene valores válidos.
E_PENDING
 La información no está disponible. Actualmente, el servicio de banda ancha móvil está sondeando el estado listo. La aplicación que realiza la llamada puede recibir una notificación cuando el estado listo esté disponible registrando para el método OnReadyStateChange de IMbnInterfaceEvents.

Comentarios

El estado listo especifica si la interfaz se inicializa correctamente y está lista para realizar operaciones de conexión. En el caso de los dispositivos basados en SIM, un dispositivo está listo cuando el dispositivo ha inicializado correctamente la SIM. El dispositivo solo se puede usar para la conexión cuando el estado listo es MBN_READY_STATE_INITIALIZED. Para obtener más información sobre otros estados de dispositivo, consulte MBN_READY_STATE.

El estado listo de una interfaz puede cambiar como resultado de una operación de usuario. Por ejemplo, cuando un usuario inserta una SIM en un dispositivo, el estado listo cambia de MBN_READY_STATE_SIM_NOT_INSERTED a otro estado listo. El estado listo también puede cambiar debido a otras operaciones realizadas por la aplicación. Por ejemplo, cuando se ha especificado un PIN, el estado listo puede cambiar de MBN_READY_STATE_DEVICE_LOCKED a otro estado listo. Una aplicación puede registrarse para recibir notificaciones de eventos siempre que haya un cambio en el estado listo de la interfaz. Se llama al miembro OnReadyStateChange de IMbnInterfaceEvents para notificar a una aplicación cualquier cambio en el estado listo.

Es posible que el subsistema sms del dispositivo no esté listo cuando notifica MBN_READY_STATE_INITIALIZED. Una aplicación que llama debe esperar una llamada al miembro OnSmsConfigurationChange de IMbnSmsEvents, lo que indica que el subsistema sms está listo.

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