Поделиться через

Метод IMbnInterface::GetReadyState (mbnapi.h)

  • Статья

Важно!

Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.

Возвращает состояние готовности.

Синтаксис

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

Параметры

[out, retval] readyState

Указатель на структуру MBN_READY_STATE . Если этот метод возвращает любое значение, отличное от S_OK, этот параметр имеет значение NULL.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод завершился успешно. ReadyState содержит допустимые значения.
E_PENDING
 Сведения недоступны. В настоящее время служба мобильной широкополосной связи выполняет поиск состояния готовности. Вызывающее приложение может получать уведомления о доступности состояния готовности, зарегистрировав метод OnReadyStateChangeобъекта IMbnInterfaceEvents.

Комментарии

Состояние готовности указывает, успешно ли инициализирован интерфейс и готов ли он к выполнению операций подключения. Для устройств на основе SIM-карты устройство готово после успешной инициализации SIM-карты устройством. Устройство можно использовать для подключения только в том случае, если состояние готовности MBN_READY_STATE_INITIALIZED. Дополнительные сведения о других состояниях устройств см. в разделе MBN_READY_STATE.

Состояние готовности интерфейса может измениться в результате операции пользователя. Например, когда пользователь вставляет SIM-карту на устройство, состояние готовности изменяется с MBN_READY_STATE_SIM_NOT_INSERTED на другое готовое состояние. Состояние готовности также может измениться из-за других операций, выполняемых приложением. Например, при вводе ПИН-кода состояние готовности может измениться с MBN_READY_STATE_DEVICE_LOCKED на другое состояние готовности. Приложение может регистрироваться для уведомлений о событиях всякий раз, когда происходит изменение состояния готовности интерфейса. Член OnReadyStateChangeIMbnInterfaceEvents вызывается для уведомления приложения о любых изменениях в состоянии готовности.

Подсистема SMS устройства может быть не готова, когда сообщает MBN_READY_STATE_INITIALIZED. Вызывающее приложение должно ожидать вызова элемента OnSmsConfigurationChangeIMbnSmsEvents, указывая, что подсистема SMS готова.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

IMbnInterface