Operace blacklistu sítě MB

Important

Bias-free communication

Microsoft podporuje různorodé a inkluzivní prostředí. Tento článek obsahuje odkazy na terminologii, kterou průvodce stylem Microsoft pro komunikaci bez předsudků, rozpozná jako vyloučení. Slovo nebo fráze se používá v tomto článku pro konzistenci, protože se aktuálně používá v softwaru. Když se software aktualizuje tak, aby odebral jazyk, bude tento článek aktualizován tak, aby byl v souladu.

Zařízení se může vyžadovat, aby se nezaregistruje do sítě v různých scénářích, například při vložení konkrétní SIM karty nebo v případě, že se zařízení nechce registrovat do konkrétní sítě. V těchto situacích systém Windows 10 verze 1703 přidává modemová rozhraní, aby operační systém mohl konfigurovat seznam zakázaných karet a poskytovatelů sítě.

Operační systém může kdykoli nakonfigurovat dvojici MCC/MNC v modemu tak, aby určil SIM kartu nebo síť, do které se zařízení nesmí zaregistrovat. Rozhraní je dostatečně flexibilní, aby umožňovalo dva různé seznamy, jeden pro poskytovatele SIM karty a druhý pro poskytovatele sítě. Pokud se zařízení nepokusilo o registraci, protože konkrétní SIM nebo síťový poskytovatel byl na seznamu zakázaných, musí modem hlásit stav registrace jako odepřený.

MB Interface Update for Network Blacklist Operations

Byl vytvořen nový příkaz MBIM, který umožňuje operačnímu systému dotazovat a nastavit dvojici MCC a MNC, se kterou by se modem neměl pokoušet o registraci, pokud je na zařízení k dispozici odpovídající SIM karty nebo poskytovatel sítě. Pro tento příkaz byl definován nový proprietární identifikátor CID MSFT jako MBIM_CID_MS_NETWORK_BLACKLIST.

Název služby = Basic Connect rozšíření

UUID = UUID_BASIC_CONNECT_EXTENSIONS

UUID Value = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf

CID	Command Code	Minimální verze operačního systému
MBIM_CID_MS_NETWORK_BLACKLIST	2	Windows 10 verze 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Description

Podniky, uživatelé nebo mobilní operátoři mohou určit sim karty a sítě, na kterých nechtějí modem registrovat. Tento příkaz slouží k tomu, aby operační systém mohl dotazovat a nastavit seznam povolených na modemu. Existují dva černé seznamy:

1. Seznam zakázaných SIM karet – SIM karty, jejichž poskytovatel je členem seznamu povolených, by nemělo být povoleno registrovat se v žádné síti.
2. Seznam zakázaných sítí – sítě na seznamu zakázaných sítí by neměly být povoleny k registraci bez ohledu na to, jakou SIM kartu na zařízení existuje.

Modem musí udržovat jak černé seznamy na modem, tak i trvalé prohození sim karty a cykly napájení. K oběma zakázaným seznamům je možné přistupovat pomocí dotazu nebo nastavení za všech okolností bez ohledu na stav SIM karty.

U příkazu Set je očekáváno, že přepíše existující černé seznamy v modemu datovou částí příkazu Set.

Query

MBIM_MS_NETWORK_BLACKLIST_INFO se vrátí z dokončeného dotazu a nastavit zprávy v InformationBufferu. Pro dotaz je InformationBuffer null.

Set

Pro sadu obsahuje InformationBuffer MBIM_MS_NETWORK_BLACKLIST_INFO. V operaci Set by měl být do modemu uveden seznam kombinací MNC/MCC. Pokud imSI SIM karty odpovídá zadané hodnotě MNC a MCC, modem by se měl znova zaregistrovat ze sítě a neměl by se pokoušet znovu zaregistrovat, dokud se nevloží nová SIM karta, která neodpovídá MNC/MCC.

Unsolicited Event

Nevyžádaná událost se očekává, pokud se některý ze stavů seznamu zakázaných změnil z aktuály na nečinný nebo naopak; Pokud se například vloží SIM karta, jejíž poskytovatel odpovídá seznamu zakázaných zprostředkovatelů SIM karty.

Parameters

Operation	Set	Query	Notification
Command	MBIM_MS_NETWORK_BLACKLIST_INFO	Not applicable	Not applicable
Response	MBIM_MS_NETWORK_BLACKLIST_INFO	MBIM_MS_NETWORK_BLACKLIST_INFO	MBIM_MS_NETWORK_BLACKLIST_INFO

Data Structures

Query

InformationBuffer musí být NULL a InformationBufferLength musí být nula.

Set

V informačním nástroji InformationBuffer se použije následující MBIM_MS_NETWORK_BLACKLIST_INFO struktura.

Offset	Size	Field	Typ	Description
0	4	BlacklistState	MBIM_MS_NETWORK_BLACKLIST_STATE	Určuje, zda jsou splněny některé z podmínek na seznamu zakázaných, které vedou k tomu, že se modem neregistruje do sítě. Další informace najdete v tabulce MBIM_MS_NETWORK_BLACKLIST_STATE.
4	4	ElementCount (EC)	UINT32	Počet MBIM_MS_NETWORK_BLACKLIST_PROVIDER struktur, které následují v objektu DataBuffer.
8	8 * EC	BlacklistProviderRefList	OL_PAIR_LIST	Prvním prvkem dvojice je 4 bajtový posun vypočítaný od začátku (posun 0) této MBIM_MS_NETWORK_BLACKLIST_INFO struktury do struktury MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Další informace najdete v tabulce MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Druhý prvek dvojice je 4 bajtová velikost ukazatele na odpovídající MBIM_MS_NETWORK_BLACKLIST_PROVIDER strukturu.
8 + (8 * EC)		DataBuffer	DATABUFFER	Pole MBIM_MS_NETWORK_BLACKLIST_PROVIDER struktur.

Následující datové struktury se používají v předchozí tabulce.

MBIM_MS_NETWORK_BLACKLIST_STATE popisuje možné stavy těchto dvou různých seznamů zakázaných.

Typ	Mask	Description
MbimMsNetworkBlacklistStateNotActuated	0h	Obě podmínky na seznamu zakázaných adres nejsou splněny.
MbimMsNetworkBlacklistSIMProviderActuated	1h	Vložená SIM karta je na seznamu zakázaných, protože JEJÍ ID zprostředkovatele odpovídá seznamu zakázaných id zprostředkovatele SIM.
MbimMsNetworkBlacklistNetworkProviderActuated	2h	Dostupné sítě jsou na seznamu zakázaných, protože jejich ID poskytovatele jsou v seznamu zakázaných pro ID poskytovatele sítě.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER určuje poskytovatele seznamu zakázaných.

Offset	Size	Field	Typ	Description
0	4	MCC	UINT32	Podle specifikace 3GPP je MCC součástí IMSI a určuje zemi poskytovatele.
4	4	MNC	UINT32	Podle specifikace 3GPP je MNC součástí IMSI a určuje síť poskytovatele.
8	4	NetworkBlacklistType	MBIM_MS_NETWORK_BLACKLIST_TYPE	Určuje, pro který typ blacklistu se použije dvojice MCC/MNC. Další informace najdete v tabulce MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE používá předchozí datová struktura. Určuje, které z těchto dvou zakázaných seznamů budou použity.

Typ	Value	Description
MbimMsNetworkBlacklistTypeSIM	0	Pár MCC/MNC se používá pro seznam zakázaných poskytovatelů SIM.
MbimMsNetworkBlacklistTypeNetwork	1	Dvojice MCC/MNC se používá pro seznam zakázaných poskytovatelů sítě.

Response

Další informace najdete v tabulce MBIM_MS_NETWORK_BLACKLIST_INFO.

Status Codes

Pro operace dotazování a nastavení:

Status Code	Description
MBIM_STATUS_READ_FAILURE	Operace selhala, protože zařízení nemohlo načíst zřízené kontexty.
MBIM_STATUS_NO_DEVICE_SUPPORT	Operace se nezdařila, protože zařízení operaci nepodporuje.

Pouze pro množinové operace:

Status Code	Description
MBIM_STATUS_INVALID_PARAMETERS	Operace selhala kvůli neplatným parametrům.
MBIM_STATUS_WRITE_FAILURE	Operace selhala, protože požadavek na aktualizaci nebyl úspěšný.