Método IMbnInterface::GetReadyState (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 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 |
|---|---|
|
El método se completó correctamente. readyState contiene valores válidos. |
|
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 |