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

Статья
08/24/2023

Важно!

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

Возвращает перемещаемый текст, описывающий поставщика роуминга.

Синтаксис

HRESULT GetRoamingText(
  [out] BSTR *roamingText
);

Параметры

[out] roamingText

Указатель на строку, содержащую дополнительные сведения о сети, в которой перемещается устройство. Максимальная длина — MBN_ROAMTEXT_LEN символов. Строка заполняется, только если метод возвращает S_OK для успешного выполнения. После успешного выполнения вызывающее приложение должно освободить выделенную память, вызвав SysFreeString.

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

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

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

Эти сведения могут изменяться при перемещении устройства мобильной широкополосной связи из одной сети в другую. Это относится к каждому изменению состояния MBN_REGISTER_STATE_HOME на MBN_REGISTER_STATE_SEARCHING в состоянии регистрации сети. Это также происходит при изменении зарегистрированной сети, например при перемещении регистрации сети от одного поставщика к другому. После таких изменений служба мобильной широкополосной связи вызовет метод OnRegisterStateChange объекта IMbnRegistrationEvents.

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

Требования


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

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

IMbnRegistration

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