MB Network Blacklist Operations
Важно!
Обмен данными без смещения
Корпорация Майкрософт поддерживает разнообразную и инклюзивную среду. В этой статье содержатся ссылки на терминологию, которую руководство майкрософт по стилю для общения без предубеждений распознает как исключающую. Слово или фраза используется в этой статье для обеспечения согласованности, так как они в настоящее время отображаются в программном обеспечении. При обновлении программного обеспечения для удаления языка эта статья будет обновлена до выравнивания.
Устройство может потребоваться, чтобы оно не регистрировалось в сети в различных сценариях, например при вставке определенного карта SIM-карты или если устройство не хочет регистрироваться в определенной сети. Для решения этих ситуаций Windows 10 версии 1703 добавляет интерфейсы модема, позволяющие ОС настраивать списки "черный" для SIM-карт и поставщиков сетей.
В любое время ОС может настроить пару MCC/MNC в модеме, чтобы указать SIM-карту или сеть, в которой устройство не может регистрироваться. Интерфейс достаточно гибкий, чтобы разрешить два разных списка: один для поставщиков SIM-карт, а другой — для поставщиков сетевых услуг. Если устройство не пыталось зарегистрировать, так как определенная SIM-карта или поставщик сети попала в список запрещенных, модем должен сообщить о состоянии регистрации как отклоненное.
Обновление интерфейса МБ для операций с черным списком сети
Была создана новая команда MBIM, позволяющая ОС запрашивать и задавать пару MCC и MNC, с которой модем не должен пытаться зарегистрировать, если на устройстве присутствует соответствующая SIM-карта или сетевой поставщик. Для этой команды новый собственный идентификатор кода кода msft определен как MBIM_CID_MS_NETWORK_BLACKLIST.
Service Name = Basic Connect Extensions
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Значение UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
CID | Код команды | Минимальная версия ОС |
---|---|---|
MBIM_CID_MS_NETWORK_BLACKLIST | 2 | Windows 10 версии 1703 |
MBIM_CID_MS_NETWORK_BLACKLIST
Описание
Предприятия, пользователи или мобильные операторы могут указать SIM-карты и сети, в которых они не хотят регистрировать модем. Эта команда используется для того, чтобы ОС могла запрашивать и задавать черные списки на модеме. Существует два черных списка:
- Список запрещенных sim-карт карта. SIM-карты, поставщик которых является участником этого списка, не должны быть разрешены для регистрации в какой-либо сети.
- Список запрещенных поставщиков сетей— сети в этом списке не должны быть разрешены для регистрации независимо от того, какие SIM-карта присутствуют на устройстве.
Модем должен поддерживать как черные списки на модем, так и сохраняться при переключениях SIM-карт и циклах питания. К обоим черным спискам можно обращаться с помощью запроса или задания в любое время, независимо от состояния SIM-карты.
Ожидается, что команда Set перезапишет существующие черные списки в модеме полезными данными команды Set.
Запрос
MBIM_MS_NETWORK_BLACKLIST_INFO возвращается из завершенных сообщений Query и Set в InformationBuffer. Для параметра Query параметр InformationBuffer имеет значение NULL.
Присвойте параметру
Для Set InformationBuffer содержит MBIM_MS_NETWORK_BLACKLIST_INFO. В операции Set для модема должен быть предоставлен список сочетаний MNC/MCC. Если IMSI SIM-карта совпадает с указанными значениями MNC и MCC, модем должен отменить регистрацию в сети и не пытаться выполнить повторную регистрацию до тех пор, пока не будет вставлен новый карта SIM-карты, который не соответствует MNC/MCC.
Незапрошенное событие
Ожидается незапрошенное событие, если какое-либо из состояний списка запрещенных изменено на бездействующее или наоборот; Например, если вставляется SIM-карта, поставщик которой соответствует списку запрещенных поставщиков SIM-карт.
Параметры
Операция | Присвойте параметру | Запрос | Уведомление |
---|---|---|---|
Get-Help | MBIM_MS_NETWORK_BLACKLIST_INFO | Неприменимо | Неприменимо |
Ответ | MBIM_MS_NETWORK_BLACKLIST_INFO | MBIM_MS_NETWORK_BLACKLIST_INFO | MBIM_MS_NETWORK_BLACKLIST_INFO |
Структуры данных
Запрос
Параметр InformationBuffer должен иметь значение NULL, а InformationBufferLength — ноль.
Присвойте параметру
Следующая MBIM_MS_NETWORK_BLACKLIST_INFO структура должна использоваться в InformationBuffer.
Offset | Размер | Поле | Тип | Описание |
---|---|---|---|---|
0 | 4 | BlacklistState | MBIM_MS_NETWORK_BLACKLIST_STATE | Указывает, выполняются ли какие-либо условия списка запрещенных, что приводит к тому, что модем не регистрируется в сети. Дополнительные сведения см. в таблице MBIM_MS_NETWORK_BLACKLIST_STATE. |
4 | 4 | ElementCount (EC) | UINT32 | Количество MBIM_MS_NETWORK_BLACKLIST_PROVIDER структур, которые следуют в DataBuffer. |
8 | 8 * EC | BlacklistProviderRefList | OL_PAIR_LIST | Первый элемент пары представляет собой смещение в 4 байта, вычисленное от начала (смещение 0) этой MBIM_MS_NETWORK_BLACKLIST_INFO структуры до структуры MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Дополнительные сведения см. в таблице MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Второй элемент пары представляет собой 4-байтовой размер указателя на соответствующую MBIM_MS_NETWORK_BLACKLIST_PROVIDER структуру. |
8 + (8 * EC) | DataBuffer | DATABUFFER | Массив структур MBIM_MS_NETWORK_BLACKLIST_PROVIDER. |
В предыдущей таблице используются следующие структуры данных.
MBIM_MS_NETWORK_BLACKLIST_STATE описывает возможные состояния двух разных списков черных.
Тип | Mask | Описание |
---|---|---|
MbimMsNetworkBlacklistStateNotActuated | 0 ч | Оба условия черного списка не выполняются. |
MbimMsNetworkBlacklistSIMProviderActuated | 1 ч | Вставленная SIM-карта включена в черный список, так как ее идентификатор поставщика совпадает с черным списком для идентификатора поставщика SIM-карты. |
MbimMsNetworkBlacklistNetworkProviderActuated | 2 ч | Доступные сети включены в черный список, так как их идентификаторы поставщиков находятся в черном списке для идентификатора поставщика сети. |
MBIM_MS_NETWORK_BLACKLIST_PROVIDER указывает поставщика списка "черный".
Offset | Размер | Поле | Тип | Описание |
---|---|---|---|---|
0 | 4 | Код MCC | UINT32 | Как указано в 3GPP, MCC является частью IMSI и указывает страну поставщика. |
4 | 4 | Код MNC | UINT32 | Как указано в 3GPP, MNC является частью IMSI и указывает сеть поставщика. |
8 | 4 | NetworkBlacklistType | MBIM_MS_NETWORK_BLACKLIST_TYPE | Указывает, для какого типа черного списка используется пара MCC/MNC. Дополнительные сведения см. в таблице MBIM_MS_NETWORK_BLACKLIST_TYPE. |
MBIM_MS_NETWORK_BLACKLIST_TYPE используется в предыдущей структуре данных. Он указывает, какой из двух списков будет использоваться.
Тип | Значение | Описание |
---|---|---|
MbimMsNetworkBlacklistTypeSIM | 0 | Пара MCC/MNC используется для списка запрещенных поставщиков SIM-карт. |
MbimMsNetworkBlacklistTypeNetwork | 1 | Пара MCC/MNC используется для списка запрещенных сетевых поставщиков. |
Ответ
Дополнительные сведения см. в таблице MBIM_MS_NETWORK_BLACKLIST_INFO.
Коды состояний
Для операций запроса и задания:
Код состояния | Описание |
---|---|
MBIM_STATUS_READ_FAILURE | Операция завершилась сбоем, так как устройству не удалось получить подготовленные контексты. |
MBIM_STATUS_NO_DEVICE_SUPPORT | Операция завершилась сбоем, так как устройство не поддерживает операцию. |
Только для операций Set:
Код состояния | Описание |
---|---|
MBIM_STATUS_INVALID_PARAMETERS | Операция завершилась сбоем из-за недопустимых параметров. |
MBIM_STATUS_WRITE_FAILURE | Операция завершилась сбоем из-за неудачного запроса на обновление. |