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

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

  • Статья

Важно!

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

Возвращает текущий класс данных в текущей сети.

Синтаксис

HRESULT GetCurrentDataClass(
  [out] ULONG *currentDataClass
);

Параметры

[out] currentDataClass

Указатель на MBN_DATA_CLASS значение. Этот параметр имеет смысл, только если функция возвращает S_OK.

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

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

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

Комментарии

Метод GetCurrentDataClass возвращает класс данных в текущей сети. Это значение можно задать MBN_DATA_CLASS_NONE , если значение неизвестно.

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

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

Требования

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

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

IMbnRegistration