структура 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 | |
|
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
Растровое изображение, представляющее классы данных, поддерживаемые устройством. Подробный список значений см. в элементе WwanDataClassWWAN_DEVICE_CAPS.
Этот элемент можно игнорировать при запросе OID_WWAN_HOME_PROVIDER.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 7 и более поздних версиях Windows. |
| Верхняя часть | wwan.h (включая Wwan.h) |