Share via

структура WWAN_PROVIDER (wwan.h)

  • Статья

Структура WWAN_PROVIDER представляет сведения о поставщике сети.

Синтаксис

typedef struct _WWAN_PROVIDER {
  WCHAR ProviderId[WWAN_PROVIDERID_LEN];
  ULONG ProviderState;
  WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
  ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;

Члены

ProviderId[WWAN_PROVIDERID_LEN]

Строка, завершающаяся значением NULL (0–9), представляющая удостоверение поставщика сети.

Для сетей на основе GSM эта строка представляет собой объединение трехзначного мобильного кода страны (MCC) и двух или трехзначного кода мобильной сети (MNC). Операторы на основе GSM могут иметь более одного MNC и, следовательно, более одного ProviderId .

Для сетей на основе CDMA эта строка представляет собой пятизначный идентификатор системы (SID). Как правило, оператор на основе CDMA имеет несколько идентификаторов безопасности. Как правило, перевозчик имеет один sid для каждого рынка, который, как правило, географически разделен в пределах страны по нормативным актам, таким как городские статистические области (MSA) в США Америки. Драйверы минипортов устройств на основе CDMA должны указывать WWAN_CDMA_DEFAULT_PROVIDER_ID, если эти сведения недоступны.

ProviderState

Значение типа , представляющее различные состояния, которыми можно пометить запись поставщика сети. В следующей таблице показаны возможные значения, которые должны указывать драйверы мини-порта (можно указать одно или несколько значений).

Значение Значение
WWAN_PROVIDER_STATE_HOME Поставщик сети является домашним оператором.
WWAN_PROVIDER_STATE_FORBIDDEN Поставщик сети находится в списке запрещенных.
WWAN_PROVIDER_STATE_PREFERRED Поставщик сети находится в списке предпочтительных.
WWAN_PROVIDER_STATE_VISIBLE Поставщик сети отображается.
WWAN_PROVIDER_STATE_REGISTERED Поставщик сети в настоящее время зарегистрирован устройством.
WWAN_PROVIDER_STATE_UNKNOWN Состояние поставщика сети неизвестно.
 

Некоторые значения из предыдущей таблицы применяются только к определенным идентификаторам объектов (OID). В следующей таблице показаны связи между этими значениями и соответствующими идентификаторами OID.

Значение OID
WWAN_PROVIDER_STATE_HOME

OID_WWAN_HOME_PROVIDER
WWAN_PROVIDER_STATE_FORBIDDEN

WWAN_PROVIDER_STATE_PREFERRED

OID_WWAN_PREFERRED_PROVIDERS
WWAN_PROVIDER_STATE_VISIBLE

WWAN_PROVIDER_STATE_REGISTERED

WWAN_PROVIDER_STATE_HOME

WWAN_PROVIDER_STATE_PREFERRED

WWAN_PROVIDER_STATE_FORBIDDEN

OID_WWAN_VISIBLE_PROVIDERS

ProviderName[WWAN_PROVIDERNAME_LEN]

Строка, завершающаяся значением NULL, представляющая имя поставщика сети. Этот элемент ограничен не более WWAN_PROVIDERNAME_LEN символами.

Для сетей на основе GSM, если предпочтительное представление инициалов страны и имя мобильной сети (PPCI&N) длиннее WWAN_PROVIDERNAME_LEN символов, драйвер мини-порта должен сократить имя сети.

Этот элемент игнорируется, когда служба MB задает список предпочтительных поставщиков.

Драйверы мини-порта должны указывать строку NULL для устройств, у которых нет этой информации.

WwanDataClass

Растровое изображение, представляющее классы данных, поддерживаемые устройством. Подробный список значений см. в элементе WwanDataClassWWAN_DEVICE_CAPS.

Этот элемент можно игнорировать при запросе OID_WWAN_HOME_PROVIDER.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 7 и более поздних версиях Windows.
Верхняя часть wwan.h (включая Wwan.h)

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

NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS

WWAN_DEVICE_CAPS