Freigeben über

Mb-Netzwerk blacklist-Vorgänge

  • Artikel

Wichtig

Vorurteilsfreie Kommunikation

Microsoft unterstützt eine vielfältige und inklusive Umgebung. Dieser Artikel enthält Verweise auf Terminologie, die im Microsoft-Stilleitfaden für voreingenommene Kommunikation als ausschlussfrei erkannt wird. Das Wort oder der Ausdruck wird in diesem Artikel aus Gründen der Konsistenz verwendet, da es derzeit in der Software angezeigt wird. Wenn die Software aktualisiert wird, um die Sprache zu entfernen, wird dieser Artikel aktualisiert, um in Übereinstimmung zu sein.

Ein Gerät kann in verschiedenen Szenarien nicht bei einem Netzwerk registriert werden, z. B. wenn eine bestimmte SIM-Karte eingefügt wird oder wenn ein Gerät sich nicht bei einem bestimmten Netzwerk registrieren möchte. Um diesen Situationen gerecht zu werden, fügt Version 1703 Windows 10 Modemschnittstellen hinzu, damit das Betriebssystem Blacklists für SIM-Karten und Netzwerkanbieter konfigurieren kann.

Das Betriebssystem kann jederzeit das MCC/MNC-Paar im Modem konfigurieren, um die SIM-Karte oder das Netzwerk anzugeben, bei dem das Gerät nicht registriert werden darf. Die Schnittstelle ist flexibel genug, um zwei verschiedene Listen zuzulassen, eine für SIM-Anbieter und eine für Netzwerkanbieter. Wenn das Gerät nicht versucht hat, sich zu registrieren, weil ein bestimmter SIM- oder Netzwerkanbieter in die Blacklist aufgenommen wurde, muss das Modem die Registrierung status als verweigert melden.

MB-Schnittstellenupdate für Netzwerk blacklist-Vorgänge

Ein neuer MBIM-Befehl wurde erstellt, damit das Betriebssystem das MCC- und MNC-Paar abfragen und festlegen kann, mit dem das Modem keine Registrierung versuchen soll, wenn auf dem Gerät eine übereinstimmende SIM-Karte oder ein Entsprechender Netzwerkanbieter vorhanden ist. Für diesen Befehl wurde eine neue proprietäre MSFT-CID als MBIM_CID_MS_NETWORK_BLACKLIST definiert.

Dienstname = Grundlegende Connect-Erweiterungen

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID Befehlscode Mindestversion des Betriebssystems
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10, Version 1703

MBIM_CID_MS_NETWORK_BLACKLIST

BESCHREIBUNG

Unternehmen, Nutzer oder Mobilfunkanbieter können die SIM-Karten und Netzwerke angeben, auf denen sich das Modem nicht registrieren soll. Dieser Befehl wird für das Betriebssystem verwendet, um die Blacklists für das Modem abfragen und festlegen zu können. Es gibt zwei Blacklists:

  1. Eine SIM-Karte Blacklist – SIM-Karten, deren Anbieter Mitglied der Blacklist ist, sollten sich in keinem Netzwerk registrieren dürfen.
  2. Blacklist eines Netzwerkanbieters: Netzwerke auf der Blacklist dürfen sich nicht registrieren, unabhängig davon, welche SIM-Karte auf dem Gerät vorhanden ist.

Das Modem muss beide Blacklists pro Modem verwalten und über SIM-Swaps und Stromzyklen hinweg beibehalten werden. Auf beide Blacklists kann jederzeit mit Abfrage oder Set zugegriffen werden, unabhängig vom SIM-Status.

Für den Befehl Set wird erwartet, dass die vorhandenen Blacklists im Modem mit der Nutzlast des Befehls Set überschrieben werden.

Abfrage

MBIM_MS_NETWORK_BLACKLIST_INFO wird von abgeschlossenen Abfrage- und Set-Nachrichten im InformationBuffer zurückgegeben. Für Abfrage ist der InformationBuffer NULL.

Set

Für Set enthält der InformationBuffer eine MBIM_MS_NETWORK_BLACKLIST_INFO. Im Set-Vorgang sollte dem Modem eine Liste von MNC/MCC-Kombinationen bereitgestellt werden. Wenn der IMSI der SIM-Karte mit dem angegebenen MNC- und MCC-Wert übereinstimmt, sollte das Modem die Registrierung beim Netzwerk aufheben und erst dann versuchen, eine neue SIM-Karte, die nicht mit dem MNC/MCC übereinstimmt, erneut zu registrieren.

Nicht angefordertes Ereignis

Ein Nicht angefordertes Ereignis wird erwartet, wenn sich einer der Blacklist-Zustände von aktiviert in nicht aktiviert geändert hat oder umgekehrt. Beispielsweise, wenn eine SIM-Karte eingefügt wird, deren Anbieter mit der Blacklist des SIM-Anbieters übereinstimmt.

Parameter

Vorgang Set Abfrage benachrichtigungs-
Get-Help MBIM_MS_NETWORK_BLACKLIST_INFO Nicht verfügbar Nicht verfügbar
Antwort MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

Datenstrukturen

Abfrage

Der InformationBuffer muss NULL und InformationBufferLength null sein.

Set

Die folgende MBIM_MS_NETWORK_BLACKLIST_INFO Struktur wird im InformationBuffer verwendet.

Offset Size Feld Typ BESCHREIBUNG
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Gibt an, ob eine der Blacklist-Bedingungen erfüllt ist, die dazu führen, dass sich das Modem nicht beim Netzwerk registriert. Weitere Informationen finden Sie in der Tabelle MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 ElementCount (EC) UINT32 Anzahl der MBIM_MS_NETWORK_BLACKLIST_PROVIDER Strukturen, die im DataBuffer folgen.
8 8 * EG BlacklistProviderRefList OL_PAIR_LIST Das erste Element des Paars ist ein 4-Byte-Offset, der vom Anfang (Offset 0) dieser MBIM_MS_NETWORK_BLACKLIST_INFO-Struktur bis zu einer MBIM_MS_NETWORK_BLACKLIST_PROVIDER-Struktur berechnet wird. Weitere Informationen finden Sie in der Tabelle MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Das zweite Element des Paars ist eine 4-Byte-Größe eines Zeigers auf die entsprechende MBIM_MS_NETWORK_BLACKLIST_PROVIDER-Struktur.
8 + (8 * EG) DataBuffer DATABUFFER Array von MBIM_MS_NETWORK_BLACKLIST_PROVIDER Strukturen.

Die folgenden Datenstrukturen werden in der vorherigen Tabelle verwendet.

MBIM_MS_NETWORK_BLACKLIST_STATE beschreibt die möglichen Zustände der beiden verschiedenen Blacklists.

Typ Mask BESCHREIBUNG
MbimMsNetworkBlacklistStateNotActuated 0h Beide Bedingungen für die Blacklist sind nicht erfüllt.
MbimMsNetworkBlacklistSIMProviderActuated 1h Die eingefügte SIM wird in die schwarze Liste aufgenommen, da ihre Anbieter-ID mit der Blacklist für SIM-Anbieter-ID übereinstimmt.
MbimMsNetworkBlacklistNetworkProviderActuated 2h Verfügbare Netzwerke werden in die schwarze Liste aufgenommen, da ihre Anbieter-IDs alle in der Blacklist für die Netzwerkanbieter-ID enthalten sind.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER gibt den Anbieter der Blacklist an.

Offset Size Feld Typ BESCHREIBUNG
0 4 MCC UINT32 Wie in 3GPP angegeben, ist MCC Teil von IMSI und gibt das Land des Anbieters an.
4 4 MNC UINT32 Wie von 3GPP angegeben, ist MNC Teil von IMSI und gibt das Netzwerk des Anbieters an.
8 4 NetworkBlacklistType MBIM_MS_NETWORK_BLACKLIST_TYPE Gibt an, für welchen Blacklisttyp das MCC/MNC-Paar verwendet wird. Weitere Informationen finden Sie in der tabelle MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE wird von der vorherigen Datenstruktur verwendet. Es gibt an, welche der beiden Blacklists verwendet wird.

Typ Wert BESCHREIBUNG
MbimMsNetworkBlacklistTypeSIM 0 Das MCC/MNC-Paar wird für die Blacklist des SIM-Anbieters verwendet.
MbimMsNetworkBlacklistTypeNetwork 1 Das MCC/MNC-Paar wird für die Blacklist des Netzwerkanbieters verwendet.

Antwort

Weitere Informationen finden Sie in der Tabelle MBIM_MS_NETWORK_BLACKLIST_INFO.

Statuscodes

Für Abfrage- und Setvorgänge:

Statuscode BESCHREIBUNG
MBIM_STATUS_READ_FAILURE Der Vorgang ist fehlgeschlagen, weil das Gerät bereitgestellte Kontexte nicht abrufen konnte.
MBIM_STATUS_NO_DEVICE_SUPPORT Fehler beim Vorgang, da das Gerät den Vorgang nicht unterstützt.

Nur für Set-Vorgänge:

Statuscode BESCHREIBUNG
MBIM_STATUS_INVALID_PARAMETERS Der Vorgang ist aufgrund ungültiger Parameter fehlgeschlagen.
MBIM_STATUS_WRITE_FAILURE Fehler beim Vorgang, weil die Updateanforderung nicht erfolgreich war.