Delen via


Blacklist-bewerkingen voor MB-netwerk

Belangrijk

Communicatie zonder vooroordelen

Microsoft ondersteunt een diverse en inclusieve omgeving. Dit artikel bevat verwijzingen naar terminologie die door de Microsoft stijlgids voor vooroordelenvrije communicatie wordt herkend als uitsluiting. Het woord of de woordgroep wordt in dit artikel gebruikt voor consistentie omdat het momenteel in de software wordt weergegeven. Wanneer de software wordt bijgewerkt om de taal te verwijderen, wordt dit artikel bijgewerkt zodat deze in overeenstemming is.

Een apparaat kan vereist zijn om zich niet te registreren bij een netwerk onder verschillende scenario's, zoals wanneer een specifieke SIM-kaart wordt ingevoegd of als een apparaat zich niet wil registreren bij een specifiek netwerk. Om deze situaties aan te pakken, voegt Windows 10 versie 1703 modeminterfaces toe om het besturingssysteem in staat te stellen blacklists te configureren voor SIM-kaarten en netwerkproviders.

Op elk gewenst moment kan het besturingssysteem het MCC/MNC-paar in de modem configureren om de SIM of het netwerk op te geven waarop het apparaat zich niet mag registreren. De interface is flexibel genoeg om twee verschillende lijsten toe te staan, één voor SIM-providers en een andere voor netwerkproviders. Als het apparaat geen registratie heeft geprobeerd omdat een bepaalde SIM- of netwerkprovider op de zwarte lijst staat, moet de modem de registratiestatus rapporteren als geweigerd.

MB Interface-update voor netwerk bloklijst-bewerkingen

Er is een nieuwe MBIM-opdracht gemaakt om het besturingssysteem in staat te stellen om een query uit te voeren en het MCC- en MNC-paar in te stellen waarmee de modem geen registratie moet proberen wanneer er een overeenkomende SIM-kaart of netwerkprovider aanwezig is op het apparaat. Voor deze opdracht is een nieuwe MSFT-bedrijfseigen CID gedefinieerd als MBIM_CID_MS_NETWORK_BLACKLIST.

Servicenaam = Basic Connect Extensions

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID Opdrachtcode Minimale versie van het besturingssysteem
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10, versie 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Beschrijving

Ondernemingen, gebruikers of mobiele operators kunnen de SIM-kaarten en netwerken opgeven waarop ze niet willen dat de modem zich registreert. Deze opdracht wordt gebruikt voor het besturingssysteem om query's uit te voeren en de zwarte lijst op de modem in te stellen. Er zijn twee zwarte lijsts:

  1. Een zwarte lijst met simkaarten - SIM-kaarten waarvan de provider lid is van de zwarte lijst mag niet worden geregistreerd op een netwerk.
  2. Een zwarte lijst met netwerkproviders: netwerken op de zwarte lijst mogen niet worden geregistreerd, ongeacht welke SIM-kaart aanwezig is op het apparaat.

De modem moet zowel blacklists per modem onderhouden als behouden tijdens SIM-wisselingen en stroomcycli. Beide blacklists kunnen altijd worden geopend met Query of Set, ongeacht de SIM-status.

Voor de opdracht Set wordt verwacht dat deze de bestaande zwarte lijsten in de modem overschrijft met de inhoud van de setopdracht.

Vraag

MBIM_MS_NETWORK_BLACKLIST_INFO wordt geretourneerd uit voltooide query en het instellen van berichten in de InformationBuffer. Voor de query is de InformationBuffer NULL.

Set

Voor Set bevat de InformationBuffer een MBIM_MS_NETWORK_BLACKLIST_INFO. In de bewerking Set moet een lijst met MNC/MCC-combinaties worden opgegeven voor de modem. Wanneer de IMSI van de SIM-kaart overeenkomt met de opgegeven MNC- en MCC-waarde, moet de modem de registratie van het netwerk ongedaan maken en niet opnieuw registreren totdat een nieuwe SIM-kaart die niet overeenkomt met de MNC/MCC wordt ingevoegd.

Ongevraagde gebeurtenis

Een ongevraagde gebeurtenis wordt verwacht als een van de blackliststatussen is veranderd van geactiveerd naar niet-geactiveerd, of omgekeerd; Als bijvoorbeeld een sim wordt ingevoegd waarvan de provider overeenkomt met de zwarte lijst van de SIM-provider.

Parameters

Operatie Instellen Vraag Melding
Bevelen MBIM_MS_NETWORK_BLACKLIST_INFO Niet van toepassing Niet van toepassing
Antwoord MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

Gegevensstructuren

Vraag

De InformationBuffer moet NULL zijn en InformationBufferLength moet nul zijn.

Instellen

De volgende MBIM_MS_NETWORK_BLACKLIST_INFO structuur wordt gebruikt in de InformationBuffer.

Compensatie Grootte Veld Type Beschrijving
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Hiermee wordt aangegeven of aan een van de voorwaarden van de zwarte lijst wordt voldaan die ertoe leiden dat de modem zich niet registreert bij het netwerk. Zie de tabel MBIM_MS_NETWORK_BLACKLIST_STATE voor meer informatie.
4 4 ElementCount (EC) UINT32 Het aantal MBIM_MS_NETWORK_BLACKLIST_PROVIDER structuren die volgen in de DataBuffer.
8 8 * EG BlacklistProviderRefList OL_PAIR_LIST Het eerste element van het paar is een offset van 4 byte, berekend vanaf het begin (verschuiving 0) van deze MBIM_MS_NETWORK_BLACKLIST_INFO structuur, naar een MBIM_MS_NETWORK_BLACKLIST_PROVIDER structuur. Zie de tabel MBIM_MS_NETWORK_BLACKLIST_PROVIDER voor meer informatie. Het tweede element van het paar is een 4-byte grote pointer naar de bijbehorende MBIM_MS_NETWORK_BLACKLIST_PROVIDER Structuur.
8 + (8 * EG) Databuffer gegevensbuffer Reeks van MBIM_MS_NETWORK_BLACKLIST_PROVIDER structuren.

De volgende gegevensstructuren worden gebruikt in de voorgaande tabel.

MBIM_MS_NETWORK_BLACKLIST_STATE beschrijft de mogelijke statussen van de twee verschillende blacklists.

Type Masker Beschrijving
MbimMsNetworkBlacklistStateNotActuated 0u Aan beide voorwaarden op de zwarte lijst wordt niet voldaan.
MbimMsNetworkBlacklistSIMProviderActuated 1u Ingevoegde SIM wordt in de zwarte lijst opgenomen omdat de provider-id overeenkomt met de zwarte lijst voor SIM-provider-id.
MbimMsNetworkBlacklistNetworkProviderActuated 2u Beschikbare netwerken worden in de zwarte lijst opgenomen omdat hun provider-id's allemaal in de zwarte lijst staan voor de netwerkprovider-id.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER geeft de provider van de zwarte lijst aan.

Afstand Grootte Veld Typ Beschrijving
0 4 MCC UINT32 Zoals opgegeven door 3GPP, maakt MCC deel uit van IMSI en geeft het land van de provider op.
4 4 MNO UINT32 Zoals opgegeven door 3GPP, maakt MNC deel uit van IMSI en geeft het netwerk van de provider op.
8 4 NetworkBlacklistType MBIM_MS_NETWORK_BLACKLIST_TYPE Specificeert voor welk type zwarte lijst het MCC/MNC-paar wordt gebruikt. Zie de tabel MBIM_MS_NETWORK_BLACKLIST_TYPE voor meer informatie.

MBIM_MS_NETWORK_BLACKLIST_TYPE wordt gebruikt door de bovengenoemde gegevensstructuur. Hiermee wordt aangegeven welke van de twee zwarte lijst's wordt gebruikt.

Type Waarde Beschrijving
MbimMsNetworkBlacklistTypeSIM 0 Het MCC/MNC-paar wordt gebruikt voor de blacklist van de SIM-provider.
MbimMsNetworkBlacklistTypeNetwork 1 Het MCC/MNC-paar wordt gebruikt voor de zwarte lijst met netwerkproviders.

Antwoord

Zie de tabel MBIM_MS_NETWORK_BLACKLIST_INFO voor meer informatie.

Statuscodes

Voor query- en setbewerkingen:

Statuscode Beschrijving
MBIM_STATUS_READ_FAILURE (leesfout) De bewerking is mislukt omdat het apparaat geen ingerichte contexten kan ophalen.
MBIM_STATUS_NO_DEVICE_SUPPORT De bewerking is mislukt omdat het apparaat de bewerking niet ondersteunt.

Alleen voor Set-bewerkingen:

Statuscode Beschrijving
MBIM_STATUS_INVALID_PARAMETERS De bewerking is mislukt vanwege ongeldige parameters.
MBIM_STATUS_WRITE_FAILURE De bewerking is mislukt omdat de updateaanvraag mislukt is.