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

1. Список запрещенных sim-карт карта. SIM-карты, поставщик которых является участником этого списка, не должны быть разрешены для регистрации в какой-либо сети.
2. Список запрещенных поставщиков сетей— сети в этом списке не должны быть разрешены для регистрации независимо от того, какие 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	Операция завершилась сбоем из-за неудачного запроса на обновление.