Opérations mb network blacklist

  • Article

Important

Communication sans stéréotype

Microsoft prend en charge un environnement diversifié et inclusif. Cet article contient des références à la terminologie que le guide de style Microsoft pour la communication sans préjugés reconnaît comme exclusion. Le mot ou l’expression est utilisé dans cet article à des fins de cohérence, car il apparaît actuellement dans le logiciel. Lorsque le logiciel est mis à jour pour supprimer la langue, cet article est mis à jour pour être aligné.

Un appareil peut être obligé de ne pas s’inscrire à un réseau dans différents scénarios, par exemple lorsqu’une carte SIM spécifique est insérée ou si un appareil ne souhaite pas s’inscrire à un réseau spécifique. Pour résoudre ces situations, Windows 10, la version 1703 ajoute des interfaces modem pour permettre au système d’exploitation de configurer des listes noires pour les cartes SIM et les fournisseurs réseau.

À tout moment, le système d’exploitation peut configurer la paire MCC/MNC dans le modem pour spécifier la carte SIM ou le réseau auquel l’appareil n’est pas autorisé à s’inscrire. L’interface est suffisamment flexible pour autoriser deux listes différentes, l’une pour les fournisseurs SIM et l’autre pour les fournisseurs réseau. Si l’appareil n’a pas tenté d’inscription parce qu’une carte SIM ou un fournisseur réseau particulier a été mis sur liste noire, le modem doit signaler que l’inscription status comme refusée.

Mise à jour de l’interface Mo pour les opérations de liste noire réseau

Une nouvelle commande MBIM a été créée pour permettre au système d’exploitation d’interroger et de définir la paire MCC et MNC avec laquelle le modem ne doit pas tenter d’inscription lorsqu’une carte SIM ou un fournisseur réseau correspondant est présent sur l’appareil. Pour cette commande, un nouveau CID propriétaire MSFT a été défini comme MBIM_CID_MS_NETWORK_BLACKLIST.

Nom du service = Extensions de connexion de base

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID Code de commande Version minimale du système d’exploitation
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10 version 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Description

Les entreprises, les utilisateurs ou les opérateurs mobiles peuvent spécifier les cartes SIM et les réseaux sur lesquels ils ne veulent pas que le modem s’inscrive. Cette commande est utilisée pour que le système d’exploitation puisse interroger et définir les listes noires sur le modem. Il existe deux listes noires :

  1. Une carte SIM carte liste noire : les cartes SIM dont le fournisseur est membre de la liste noire ne doivent pas être autorisées à s’inscrire sur n’importe quel réseau.
  2. Liste noire du fournisseur de réseau : les réseaux de la liste noire ne doivent pas être autorisés à s’inscrire, quelle que soit la carte SIM présente sur l’appareil.

Le modem doit conserver les listes noires par modem et persister entre les permutations SIM et les cycles d’alimentation. Les deux listes noires sont accessibles avec Query ou Set à tout moment, quel que soit l’état SIM.

Pour la commande Set, il est prévu de remplacer les listes noires existantes dans le modem par la charge utile de la commande Set.

Requête

MBIM_MS_NETWORK_BLACKLIST_INFO est retourné à partir des messages Requête et Définir terminés dans InformationBuffer. Pour Query, informationBuffer a la valeur NULL.

Définissez

Pour Définir, informationBuffer contient un MBIM_MS_NETWORK_BLACKLIST_INFO. Dans l’opération Définir, une liste de combinaisons MNC/MCC doit être fournie au modem. Lorsque l’IMSI de l’carte SIM correspond à la valeur MNC et MCC spécifiée, le modem doit annuler l’inscription du réseau et ne doit pas essayer de se réinscrire tant qu’une nouvelle carte SIM qui ne correspond pas au MNC/MCC n’a pas été insérée.

Événement non sollicité

Un événement non sollicité est attendu si l’un des états de liste noire est passé d’actionné à non actionné, ou inversement ; par exemple, si une carte SIM est insérée dont le fournisseur correspond à la liste noire du fournisseur SIM.

Paramètres

Opération Définissez Requête Notification
Commande MBIM_MS_NETWORK_BLACKLIST_INFO Non applicable Non applicable
response MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

Structures de données

Requête

InformationBuffer doit avoir la valeur NULL et InformationBufferLength doit être égal à zéro.

Définissez

La structure MBIM_MS_NETWORK_BLACKLIST_INFO suivante doit être utilisée dans InformationBuffer.

Offset Taille Champ Type Description
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Indique si l’une des conditions de liste noire est remplie et que le modem ne s’inscrit pas sur le réseau. Pour plus d’informations, consultez le tableau MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 ElementCount (EC) UINT32 Nombre de structures MBIM_MS_NETWORK_BLACKLIST_PROVIDER qui suivent dans DataBuffer.
8 8 * EC BlacklistProviderRefList OL_PAIR_LIST Le premier élément de la paire est un décalage de 4 octets, calculé à partir du début (décalage 0) de cette structure MBIM_MS_NETWORK_BLACKLIST_INFO, vers une structure MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Pour plus d’informations, consultez le tableau MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Le deuxième élément de la paire est une taille de 4 octets d’un pointeur vers la structure MBIM_MS_NETWORK_BLACKLIST_PROVIDER correspondante.
8 + (8 * EC) DataBuffer DATABUFFER Tableau de structures MBIM_MS_NETWORK_BLACKLIST_PROVIDER.

Les structures de données suivantes sont utilisées dans le tableau précédent.

MBIM_MS_NETWORK_BLACKLIST_STATE décrit les états possibles des deux listes noires différentes.

Type Mask Description
MbimMsNetworkBlacklistStateNotActuated 0h Les deux conditions de liste noire ne sont pas remplies.
MbimMsNetworkBlacklistSIMProviderActuated 1h La carte SIM insérée est mise sur liste rouge, car son ID de fournisseur correspond à la liste rouge de l’ID du fournisseur SIM.
MbimMsNetworkBlacklistNetworkProviderActuated 2 h Les réseaux disponibles sont mis sur liste noire, car leurs ID de fournisseur sont tous dans la liste rouge pour l’ID de fournisseur réseau.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER spécifie le fournisseur de la liste rouge.

Offset Taille Champ Type Description
0 4 MCC UINT32 Comme spécifié par 3GPP, MCC fait partie d’IMSI et spécifie le pays du fournisseur.
4 4 MNC UINT32 Comme spécifié par 3GPP, MNC fait partie d’IMSI et spécifie le réseau du fournisseur.
8 4 NetworkBlacklistType MBIM_MS_NETWORK_BLACKLIST_TYPE Spécifie pour quel type de liste rouge la paire MCC/MNC est utilisée. Pour plus d’informations, consultez la table MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE est utilisé par la structure de données précédente. Elle spécifie laquelle des deux listes noires sera utilisée.

Type Valeur Description
MbimMsNetworkBlacklistTypeSIM 0 La paire MCC/MNC est utilisée pour la liste rouge des fournisseurs de cartes SIM.
MbimMsNetworkBlacklistTypeNetwork 1 La paire MCC/MNC est utilisée pour la liste rouge des fournisseurs de réseau.

response

Pour plus d’informations, consultez le tableau MBIM_MS_NETWORK_BLACKLIST_INFO.

Codes d’état

Pour les opérations de requête et de définition :

Code d’état Description
MBIM_STATUS_READ_FAILURE L’opération a échoué, car l’appareil n’a pas pu récupérer les contextes provisionnés.
MBIM_STATUS_NO_DEVICE_SUPPORT L’opération a échoué, car l’appareil ne prend pas en charge l’opération.

Pour les opérations Définir uniquement :

Code d’état Description
MBIM_STATUS_INVALID_PARAMETERS L’opération a échoué en raison de paramètres non valides.
MBIM_STATUS_WRITE_FAILURE L’opération a échoué, car la demande de mise à jour a échoué.