Condividi tramite

MB Network Blacklist Operations

  • Articolo

Importante

Comunicazione senza distorsione

Microsoft supporta un ambiente diversificato e inclusivo. Questo articolo contiene riferimenti alla terminologia riconosciuta dalla guida di stile Microsoft per le comunicazioni senza distorsioni come esclusioni. La parola o la frase viene usata in questo articolo per coerenza perché è attualmente presente nel software. Quando il software viene aggiornato per rimuovere la lingua, questo articolo verrà aggiornato in modo che sia allineato.

Potrebbe essere necessario che un dispositivo non si registri in una rete in vari scenari, ad esempio quando viene inserita una scheda SIM specifica o se un dispositivo non vuole eseguire la registrazione in una rete specifica. Per risolvere queste situazioni, Windows 10, la versione 1703 aggiunge interfacce modem per consentire al sistema operativo di configurare elenchi di elementi non consentiti per le schede SIM e i provider di rete.

In qualsiasi momento, il sistema operativo può configurare la coppia MCC/MNC nel modem per specificare la SIM o la rete in cui il dispositivo non è autorizzato a registrarsi. L'interfaccia è sufficientemente flessibile per consentire due elenchi diversi, uno per i provider SIM e un altro per i provider di rete. Se il dispositivo non ha tentato la registrazione perché un determinato provider di rete o SIM è stato inserito nell'elenco elementi non consentiti, il modem deve segnalare lo stato di registrazione come negato.

Aggiornamento dell'interfaccia MB per le operazioni blacklist di rete

È stato creato un nuovo comando MBIM per consentire al sistema operativo di eseguire query e impostare la coppia MCC e MNC con cui il modem non deve tentare la registrazione quando nel dispositivo sono presenti schede SIM o provider di rete corrispondenti. Per questo comando, un nuovo CID proprietario di MSFT è stato definito come MBIM_CID_MS_NETWORK_BLACKLIST.

Nome servizio = Estensioni di connessione di base

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID Codice dei comandi Versione minima del sistema operativo
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10 versione 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Descrizione

Le aziende, gli utenti o gli operatori di telefonia mobile possono specificare le schede SIM e le reti in cui non vogliono registrare il modem. Questo comando viene usato per consentire al sistema operativo di eseguire query e impostare le blacklist sul modem. Esistono due blacklist:

  1. Una scheda SIM blacklist: le schede SIM il cui provider è un membro della blacklist non devono essere autorizzate a registrarsi in alcuna rete.
  2. Un provider di rete blacklist: le reti nella blacklist non devono essere autorizzate a registrarsi indipendentemente dalla scheda SIM presente nel dispositivo.

Il modem deve mantenere entrambe le liste nere per modem e persistenza tra scambi SIM e cicli di alimentazione. È possibile accedere a entrambe le blacklist con Query o Imposta in qualsiasi momento, indipendentemente dallo stato della SIM.

Per il comando Set è previsto sovrascrivere le blacklist esistenti nel modem con il payload del comando Imposta.

Query

MBIM_MS_NETWORK_BLACKLIST_INFO viene restituito dalla query completata e imposta i messaggi in InformationBuffer. Per Query, InformationBuffer è NULL.

Set

Per Set, InformationBuffer contiene una MBIM_MS_NETWORK_BLACKLIST_INFO. Nell'operazione Imposta è necessario specificare un elenco di combinazioni MNC/MCC al modem. Quando l'IMSI della scheda SIM corrisponde al valore MNC e MCC specificato, il modem deve annullare la registrazione dalla rete e non deve tentare di ripetere la registrazione fino a quando non viene inserita una nuova scheda SIM che non corrisponde a MNC/MCC.

Evento non richiesto

È previsto un evento non richiesto se uno degli stati dell'elenco elementi non consentiti è stato modificato da actuated a notctuated o viceversa; ad esempio, se viene inserita una SIM il cui provider corrisponde all'elenco di elementi non consentiti dal provider SIM.

Parametri

Operazione Set Query Notifica
Comando MBIM_MS_NETWORK_BLACKLIST_INFO Non applicabile Non applicabile
Risposta MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

strutture di dati

Query

InformationBuffer deve essere NULL e InformationBufferLength sarà zero.

Set

La struttura di MBIM_MS_NETWORK_BLACKLIST_INFO seguente deve essere utilizzata in InformationBuffer.

Offset Dimensione Campo Tipo Descrizione
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Indica se vengono soddisfatte le condizioni dell'elenco elementi non consentiti che comportano la mancata registrazione del modem nella rete. Per altre informazioni, vedere la tabella MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 ElementCount (EC) UINT32 Numero di strutture MBIM_MS_NETWORK_BLACKLIST_PROVIDER seguenti in DataBuffer.
8 8 * EC BlacklistProviderRefList OL_PAIR_LIST Il primo elemento della coppia è un offset di 4 byte, calcolato dall'inizio (offset 0) di questa struttura MBIM_MS_NETWORK_BLACKLIST_INFO, a una struttura MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Per altre informazioni, vedere la tabella MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Il secondo elemento della coppia è una dimensione a 4 byte di un puntatore alla struttura MBIM_MS_NETWORK_BLACKLIST_PROVIDER corrispondente.
8 + (8 * EC) DataBuffer DATABUFFER Matrice di strutture MBIM_MS_NETWORK_BLACKLIST_PROVIDER.

Nella tabella precedente vengono utilizzate le strutture di dati seguenti.

MBIM_MS_NETWORK_BLACKLIST_STATE descrive i possibili stati delle due diverse liste nere.

Tipo Mask Descrizione
MbimMsNetworkBlacklistStateNotActuated 0h Entrambe le condizioni dell'elenco elementi non vengono soddisfatte.
MbimMsNetworkBlacklistSIMProviderActuated 1h La SIM inserita viene inserita nell'elenco elementi non consentiti perché l'ID provider corrisponde all'elenco elementi non consentiti per l'ID provider SIM.
MbimMsNetworkBlacklistNetworkProviderActuated 2 h Le reti disponibili sono elencate in modo nero perché gli ID provider sono tutti inclusi nell'elenco elementi non consentiti per l'ID del provider di rete.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER specifica il provider dell'elenco elementi non consentiti.

Offset Dimensione Campo Tipo Descrizione
0 4 MCC UINT32 Come specificato da 3GPP, MCC fa parte di IMSI e specifica il paese del provider.
4 4 MNC UINT32 Come specificato da 3GPP, MNC fa parte di IMSI e specifica la rete del provider.
8 4 NetworkBlacklistType MBIM_MS_NETWORK_BLACKLIST_TYPE Specifica per quale tipo di blacklist viene utilizzata la coppia MCC/MNC. Per altre informazioni, vedere la tabella MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE viene usato dalla struttura dei dati precedente. Specifica quale delle due liste nere verrà utilizzata.

Type valore Descrizione
MbimMsNetworkBlacklistTypeSIM 0 La coppia MCC/MNC viene usata per la lista nera del provider SIM.
MbimMsNetworkBlacklistTypeNetwork 1 La coppia MCC/MNC viene usata per la blacklist del provider di rete.

Risposta

Per altre informazioni, vedere la tabella MBIM_MS_NETWORK_BLACKLIST_INFO.

Codici di stato

Per le operazioni di query e set:

Codice di stato Descrizione
MBIM_STATUS_READ_FAILURE L'operazione non è riuscita perché il dispositivo non è riuscito a recuperare i contesti di cui è stato effettuato il provisioning.
MBIM_STATUS_NO_DEVICE_SUPPORT L'operazione non è riuscita perché il dispositivo non supporta l'operazione.

Solo per le operazioni Set:

Codice di stato Descrizione
MBIM_STATUS_INVALID_PARAMETERS L'operazione non è riuscita a causa di parametri non validi.
MBIM_STATUS_WRITE_FAILURE L'operazione non è riuscita perché la richiesta di aggiornamento non è riuscita.