Udostępnij za pośrednictwem

Operacje na czarnej liście sieci MB

  • Artykuł

Ważny

Komunikacja bezstronna

Firma Microsoft obsługuje zróżnicowane i inkluzywne środowisko. Ten artykuł zawiera odwołania do terminologii, którą przewodnik po stylu firmy Microsoft w sprawie bezstronnej komunikacji uznaje za wykluczającą. Słowo lub fraza jest używana w tym artykule na potrzeby spójności, ponieważ jest ona obecnie wyświetlana w oprogramowaniu. Po zaktualizowaniu oprogramowania w celu usunięcia języka ten artykuł zostanie zaktualizowany tak, aby był wyrównany.

Może być wymagane, aby urządzenie nie rejestrowało się w sieci w różnych scenariuszach, na przykład z określoną kartą SIM lub jeśli urządzenie nie chciałoby rejestrować się w wybranej sieci. Aby rozwiązać te problemy, system Windows 10 w wersji 1703 dodaje interfejsy modemu, aby umożliwić systemowi operacyjnemu konfigurowanie czarnych list dla kart SIM i dostawców sieci.

W dowolnym momencie system operacyjny może skonfigurować parę MCC/MNC w modemie, aby określić kartę SIM lub sieć, do której urządzenie nie może się zarejestrować. Interfejs jest wystarczająco elastyczny, aby zezwolić na dwie różne listy, jeden dla dostawców sim, a drugi dla dostawców sieci. Jeśli urządzenie nie próbowało rejestracji, ponieważ określona karta SIM lub dostawca sieci został na czarnej liście, modem musi zgłosić stan rejestracji jako odrzucony.

Aktualizacja interfejsu MB dla operacji zarządzania czarną listą sieci

Utworzono nowe polecenie MBIM umożliwiające systemowi operacyjnemu wykonywanie zapytań i ustawianie pary MCC i MNC, z którą modem nie powinien podejmować próby rejestracji, gdy na urządzeniu znajduje się pasująca karta SIM lub dostawca sieci. W tym poleceniu zdefiniowano nową zastrzeżoną przez MSFT CID pod nazwą MBIM_CID_MS_NETWORK_BLACKLIST.

Nazwa usługi = podstawowe rozszerzenia programu Connect

UUID = UUID_BASIC_CONNECT_EXTENSIONS

Wartość UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf

CID Kod polecenia Minimalna wersja systemu operacyjnego
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10, wersja 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Opis

Przedsiębiorstwa, użytkownicy lub operatorzy mobilni mogą określać karty SIM i sieci, na których nie chcą zarejestrować modemu. To polecenie umożliwia systemowi operacyjnemu wykonywanie zapytań i ustawianie czarnych list na modemie. Istnieją dwie czarne listy:

  1. lista kart SIM — karty SIM, których dostawca jest członkiem czarnej listy, nie powinny być dozwolone do zarejestrowania się w żadnej sieci.
  2. lista dostawców sieci — sieci na czarnej liście nie powinny być dozwolone do zarejestrowania niezależnie od tego, jaka karta SIM jest obecna na urządzeniu.

Modem musi utrzymywać czarne listy dla każdego modemu oraz pozostawać aktywnym podczas zamiany kart SIM i cykli zasilania. Dostęp do obu list można uzyskać za pomocą opcji Zapytanie lub Ustaw przez cały czas, niezależnie od stanu karty SIM.

W przypadku polecenia Ustaw oczekiwane jest zastąpienie istniejących list zablokowanych w modemie zawartością polecenia Ustaw.

Zapytanie

MBIM_MS_NETWORK_BLACKLIST_INFO jest zwracany z ukończonych zapytań i komunikatów ustawień w usłudze InformationBuffer. W przypadku zapytania wartość InformationBuffer ma wartość NULL.

Zbiór

Dla ustawienia, InformationBuffer zawiera MBIM_MS_NETWORK_BLACKLIST_INFO. W operacji Set należy podać listę kombinacji MNC/MCC do modemu. Gdy karta SIM IMSI jest zgodna z określoną wartością MNC i MCC, modem powinien wyrejestrować się z sieci i nie należy próbować ponownie wyrejestrować, dopóki nie zostanie wstawiona nowa karta SIM, która nie jest zgodna z MNC/MCC.

Zdarzenie niezamówione

Zdarzenie niechciane jest oczekiwane, jeśli którykolwiek ze stanów na czarnej liście zmienił się z uruchomionego na nieuruchomione lub odwrotnie; na przykład w przypadku włożenia karty SIM, której dostawca znajduje się na czarnej liście dostawców SIM.

Parametry

Operacja Zbiór Zapytanie Powiadomienie
Polecenie MBIM_MS_NETWORK_BLACKLIST_INFO Nie dotyczy Nie dotyczy
Odpowiedź MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

Struktury danych

Zapytanie

Wartość InformationBuffer ma wartość NULL, a wartość InformationBufferLength wynosi zero.

Zbiór

W strukturze InformationBuffer należy użyć następującej struktury MBIM_MS_NETWORK_BLACKLIST_INFO.

Przesunięcie Rozmiar Pole Typ Opis
0 4 BlacklistState MBIM_MS_STAN_CZARNEJ_LISTY_SIECI Wskazuje, czy którykolwiek z warunków czarnej listy jest spełniony, co powoduje, że modem nie rejestruje się w sieci. Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 ElementCount (EC) UINT32 Liczba struktur MBIM_MS_NETWORK_BLACKLIST_PROVIDER, które następują w DataBufferze.
8 8 * EC BlacklistProviderRefList OL_PAIR_LIST Pierwszym elementem pary jest 4-bajtowe przesunięcie obliczane jako odległość od początku (przesunięcie 0) tej struktury MBIM_MS_NETWORK_BLACKLIST_INFO do struktury MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Drugi element pary jest 4-bajtowy i odnosi się do rozmiaru wskaźnika prowadzącego do odpowiedniej struktury MBIM_MS_NETWORK_BLACKLIST_PROVIDER.
8 + (8 * EC) Bufor danych DATABUFFER Tablica struktur MBIM_MS_NETWORK_BLACKLIST_PROVIDER.

Poniższe struktury danych są używane w poprzedniej tabeli.

MBIM_MS_NETWORK_BLACKLIST_STATE opisuje możliwe stany dwóch różnych czarnych list.

Typ Maska Opis
MbimMsNetworkBlacklistStateNotActuated 0h Oba warunki listy czarnej nie są spełnione.
MbimMsNetworkBlacklistSIMProviderActuated 1h Wstawiona karta SIM jest na czarnej liście, ponieważ jego identyfikator dostawcy jest zgodny z czarną listą identyfikatora dostawcy SIM.
MbimMsNetworkBlacklistNetworkProviderActuated 2 godz. Dostępne sieci są zablokowane, ponieważ ich identyfikatory dostawcy znajdują się na czarnej liście identyfikatorów dostawców sieci.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER określa dostawcę czarnej listy.

Przesunięcie Rozmiar Pole Typ Opis
0 4 MCK UINT32 Zgodnie ze specyfikacjami 3GPP, MCC jest częścią IMSI i określa kraj dostawcy usług.
4 4 MNC UINT32 Zgodnie z opisem w formacie 3GPP, MNC jest częścią interfejsu IMSI i określa sieć dostawcy.
8 4 TypCzarnejListySieciowej MBIM_MS_NETWORK_BLACKLIST_TYPE Określa, dla którego typu czarnej listy używana jest para MCC/MNC. Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE jest używany przez poprzednią strukturę danych. Określa, które z dwóch czarnych list będą używane.

Typ Wartość Opis
MbimMsNetworkBlacklistTypeSIM 0 Zestawienie MCC/MNC jest używane do listy blokowanych dostawców SIM.
MbimMsNetworkBlacklistTypeNetwork 1 Para MCC/MNC jest używana do tworzenia czarnej listy operatorów sieciowych.

Odpowiedź

Aby uzyskać więcej informacji, zobacz tabelę MBIM_MS_NETWORK_BLACKLIST_INFO.

Kody stanu

W przypadku operacji zapytań i ustawień:

Kod stanu Opis
Awaria odczytu MBIM_STATUS Operacja nie powiodła się, ponieważ urządzenie nie mogło pobrać zaaprowizowanych kontekstów.
MBIM_STATUS_BRAK_URZĄDZENIA_WSPARCIA Operacja nie powiodła się, ponieważ urządzenie nie obsługuje operacji.

W przypadku ustawiania tylko operacji:

Kod stanu Opis
MBIM_STATUS_INVALID_PARAMETERS Operacja nie powiodła się z powodu nieprawidłowych parametrów.
MBIM_STATUS_BŁĄD_ZAPISU Operacja nie powiodła się, ponieważ żądanie aktualizacji nie powiodło się.