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

Метод IMbnRegistration::GetRegisterState (mbnapi.h)

  • Статья

Важно!

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

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

Синтаксис

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

Параметры

[out] registerState

Указатель MBN_REGISTER_STATE значение, указывающее на текущее состояние регистрации устройства. Значение имеет смысл только в том случае, если метод вернул S_OK.

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

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

Код возврата Описание
S_OK
 Операция выполнена успешно.
E_PENDING
 Состояние регистрации недоступно. Служба мобильной широкополосной связи в настоящее время проверит устройство на наличие информации. Когда состояние регистрации доступно, служба мобильной широкополосной связи вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
 Для получения состояния регистрации требуется ПИН-код.

Комментарии

Метод GetRegisterState получает текущее состояние сетевой регистрации устройства. Устройство можно зарегистрировать в сети, выполнить поиск в сети для регистрации, или ему может быть отказано в регистрации.

Состояние регистрации устройства может измениться автоматически. Например, когда устройство выходит из области покрытия сети, оно изменяет состояние регистрации с MBN_REGISTER_STATE_HOME на MBN_REGISTER_STATE_SEARCHING.

Приложение может зарегистрироваться для получения обновлений об изменениях состояния регистрации, подключив интерфейс IMbnRegistrationEvents . Windows вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents , чтобы уведомить приложение об этих изменениях.

Для E_MBN_PIN_REQUIRED ошибки, которую можно исправить, служба мобильной широкополосной связи снова попытается получить эти сведения с устройства, когда состояние ошибки закончится (при вводе ПИН-кода). Затем он вызовет метод OnRegisterStateChangeобъекта IMbnRegistrationEvents.

Требования

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

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

IMbnRegistration