структура 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 имеет несколько идентификаторов безопасности. Как правило, перевозчик имеет один идентификатор БЕЗОПАСНОСТИ для каждого рынка, который обычно делится географически в пределах страны по правилам, таким как городские статистические районы (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 | |
|
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
ProviderName[WWAN_PROVIDERNAME_LEN]
Строка, завершающая значение NULL, представляющая имя поставщика сети. Этот элемент ограничен, по крайней мере, WWAN_PROVIDERNAME_LEN символами.
Для сетей на основе GSM, если предпочтительная презентация стран инициалов мобильной сети (PPCI&N) превышает WWAN_PROVIDERNAME_LEN символов, минипорт-драйвер должен сократить имя сети.
Этот член игнорируется, если служба MB задает список предпочитаемых поставщиков.
Драйверы минипорта должны указывать строку NULL для устройств, не имеющих этих сведений.
WwanDataClass
Растровое изображение, представляющее классы данных, поддерживаемые устройством. Подробный список значений см. в разделе WwanDataClass члена WWAN_DEVICE_CAPS.
Этот элемент можно игнорировать при запросе на OID_WWAN_HOME_PROVIDER.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 7 и более поздних версиях Windows. |
| заголовка | wwan.h (include Wwan.h) |