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

Операции с черным списком сети MB

  • Статья

Важный

Взаимодействие без предвзятости

Корпорация Майкрософт поддерживает разнообразную и инклюзивное окружение. В этой статье содержатся упоминания о терминологии, которую руководство по стилю Microsoft для безпредвзятого общения признает как исключающую. Слово или фраза в этой статье используется для согласованности, так как она в настоящее время отображается в программном обеспечении. При обновлении программного обеспечения для удаления языка эта статья будет обновлена для выравнивания.

Устройству может потребоваться не регистрироваться в сети в различных сценариях, например, если вставлена определённая SIM-карта или если устройство не хочет регистрироваться в конкретной сети. Для решения этих ситуаций Windows 10 версии 1703 добавляет интерфейсы модема, чтобы разрешить ОС настраивать черные списки для SIM-карт и сетевых поставщиков.

В любое время ОС может настроить пару MCC/MNC в модеме, чтобы указать SIM-карту или сеть, в которую устройство не разрешено зарегистрировать. Интерфейс достаточно гибкий, чтобы разрешить два разных списка, один для поставщиков SIM-карт и другой для сетевых поставщиков. Если устройство не пыталось зарегистрировать, так как определенный SIM-код или поставщик сети был добавлен в черный список, модем должен сообщить о состоянии регистрации, как отклонено.

Обновление интерфейса MB для операций сетевой блокировки

Была создана новая команда MBIM, позволяющая ОС запрашивать и устанавливать пару MCC и MNC, с которой модем не должен пытаться зарегистрироваться, если на устройстве присутствует соответствующая SIM-карта или сетевой провайдер. Для этой команды новый идентификатор CID MSFT определен как MBIM_CID_MS_NETWORK_BLACKLIST.

Имя службы = базовые расширения подключения

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-карты и сети, в которых они не хотят регистрировать модем. Эта команда используется для того, чтобы ОС могла запрашивать и задавать черные списки на модеме. Существует два черных списка:

  1. Черный список SIM-карт — SIM-карты, поставщик которых является членом черного списка, не должны быть разрешены для регистрации в любой сети.
  2. Черный список поставщиков сети — сети в черном списке не должны быть разрешены регистрировать независимо от того, какая SIM-карта присутствует на устройстве.

Модем должен поддерживать как черные списки для каждого модема и сохранять их неизменными при замене SIM-карт и перезагрузках питания. Доступ к обоим черным спискам можно получить с помощью запроса или задания в любое время независимо от состояния SIM- карты.

Для команды Set следует перезаписать существующие черные списки в модеме с помощью данных полезной нагрузки команды Set.

Запрос

MBIM_MS_NETWORK_BLACKLIST_INFO возвращается из завершенных сообщений запроса и установки в InformationBuffer. Для запроса InformationBuffer имеет значение NULL.

Набор

Для установки InformationBuffer содержит MBIM_MS_NETWORK_BLACKLIST_INFO. В операции Set необходимо указать список сочетаний MNC/MCC для модема. Если IMSI SIM-карты соответствует указанному значению MNC и MCC, модем должен выйти из сети и не пытаться повторно зарегистрироваться до тех пор, пока не будет вставлена новая SIM-карта, которая не соответствует MNC/MCC.

Незапрошенное событие

Ожидается непрошенное событие, если любое из состояний черного списка изменилось с активного на неактивное или наоборот; Например, если вставлена ​​SIM-карта, провайдер которой соответствует черному списку провайдеров SIM-карт.

Параметры

Операция Набор Запрос Уведомление
Команда 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.

Смещение Размер Поле Тип Описание
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Указывает, выполнены ли какие-либо из условий черного списка, что приводит к тому, что модем не регистрируется в сети. Для получения дополнительной информации, см. таблицу MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 КоличествоЭлементов (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) Буфер данных буфер данных Массив структур MBIM_MS_NETWORK_BLACKLIST_PROVIDER.

В предыдущей таблице используются следующие структуры данных.

MBIM_MS_NETWORK_BLACKLIST_STATE описывает возможные состояния двух разных черных списков.

Тип Маска Описание
MbimMsNetworkBlacklistStateNotActuated 0 ч Оба условия черного списка не выполняются.
Черный список сети MbimMs, инициируемый поставщиком SIM-карты 1ч Вставляемый SIM-код является черным, так как идентификатор поставщика соответствует черному списку для идентификатора поставщика SIM-карт.
MbimMsNetworkBlacklistNetworkProviderActuated 2ч Доступные сети добавлены в черный список, поскольку все идентификаторы их поставщиков находятся в черном списке для идентификаторов поставщиков сети.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER указывает на поставщика черного списка.

Смещение Размер Поле Тип Описание
0 4 MCC UINT32 Как указано в 3GPP, MCC является частью IMSI и указывает страну поставщика.
4 4 Международная корпорация UINT32 Как указано в 3GPP, MNC является частью IMSI и указывает сеть поставщика.
8 4 Тип черного списка сети 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 (ошибка записи) Операция завершилась ошибкой, так как запрос на обновление был неудачным.