Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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:
- Een zwarte lijst met simkaarten - SIM-kaarten waarvan de provider lid is van de zwarte lijst mag niet worden geregistreerd op een netwerk.
- 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. |