Operações de lista negra de rede mb

  • Artigo

Importante

Comunicação livre de desvio

A Microsoft dá suporte a um ambiente diversificado e inclusivo. Este artigo contém referências à terminologia que o guia de estilo da Microsoft para comunicação sem preconceitos reconhece como excludente. A palavra ou frase é usada neste artigo para consistência porque ela aparece atualmente no software. Quando o software for atualizado para remover o idioma, este artigo será atualizado para estar em alinhamento.

Um dispositivo pode ser necessário para não se registrar em uma rede em vários cenários, como quando uma cartão SIM específica é inserida ou se um dispositivo não deseja se registrar em uma rede específica. Para resolver essas situações, Windows 10, a versão 1703 está adicionando interfaces de modem para permitir que o sistema operacional configure listas negras para cartões SIM e provedores de rede.

A qualquer momento, o sistema operacional pode configurar o par MCC/MNC no modem para especificar o SIM ou a rede à qual o dispositivo não tem permissão para registrar. A interface é flexível o suficiente para permitir duas listas diferentes, uma para provedores SIM e outra para provedores de rede. Se o dispositivo não tentou o registro porque um provedor de rede ou SIM específico estava na lista negra, o modem deve relatar o registro status conforme negado.

Atualização de interface MB para operações de lista negra de rede

Um novo comando MBIM foi criado para permitir que o sistema operacional consulte e defina o par MCC e MNC com o qual o modem não deve tentar o registro quando um provedor de rede ou cartões SIM correspondentes estiver presente no dispositivo. Para esse comando, um novo CID proprietário do MSFT foi definido como MBIM_CID_MS_NETWORK_BLACKLIST.

Nome do Serviço = Extensões básicas de conexão

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID Código de comando Versão mínima do sistema operacional
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10, versão 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Descrição

Empresas, usuários ou operadoras móveis podem especificar os cartões SIM e redes nas quais não desejam que o modem se registre. Esse comando é usado para que o sistema operacional possa consultar e definir as listas negras no modem. Há duas listas negras:

  1. Um SIM cartão lista negra – os cartões SIM cujo provedor é membro da lista negra não devem ter permissão para se registrar em nenhuma rede.
  2. Uma lista negra do provedor de rede – as redes na lista negra não devem ter permissão para se registrar, independentemente de qual cartão SIM esteja presente no dispositivo.

O modem precisa manter as duas listas negras por modem e persistir entre trocas de SIM e ciclos de energia. Ambas as listas negras podem ser acessadas com Consulta ou Definidas o tempo todo, independentemente do estado do SIM.

Para o comando Set, espera-se substituir as listas negras existentes no modem pelo conteúdo do comando Set.

Consulta

MBIM_MS_NETWORK_BLACKLIST_INFO é retornado da consulta concluída e definir mensagens no InformationBuffer. Para Consulta, o InformationBuffer é NULL.

Definir

Para Set, o InformationBuffer contém um MBIM_MS_NETWORK_BLACKLIST_INFO. Na operação Definir, uma lista de combinações MNC/MCC deve ser fornecida ao modem. Quando o IMSI do cartão SIM corresponde ao valor de MNC e MCC especificados, o modem deve cancelar o registro da rede e não deve tentar registrar novamente até que um novo cartão SIM que não corresponda ao MNC/MCC seja inserido.

Evento não solicitado

Um Evento Não Solicitado é esperado se qualquer um dos estados da lista negra tiver mudado de atuado para não atuado ou vice-versa; por exemplo, se um SIM for inserido cujo provedor corresponde à lista negra do provedor SIM.

Parâmetros

Operação Definir Consulta Notificação
Comando MBIM_MS_NETWORK_BLACKLIST_INFO Não aplicável Não aplicável
Resposta MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

estruturas de dados

Consulta

O InformationBuffer será NULL e InformationBufferLength será zero.

Definir

A estrutura de MBIM_MS_NETWORK_BLACKLIST_INFO a seguir deve ser usada no InformationBuffer.

Deslocamento Tamanho Campo Tipo Descrição
0 4 BlacklistState MBIM_MS_NETWORK_BLACKLIST_STATE Indica se alguma das condições de lista negra é atendida, o que resulta no modem não se registrando na rede. Para obter mais informações, consulte a tabela MBIM_MS_NETWORK_BLACKLIST_STATE.
4 4 ElementCount (EC) UINT32 Contagem de MBIM_MS_NETWORK_BLACKLIST_PROVIDER estruturas que seguem no DataBuffer.
8 8 * EC BlacklistProviderRefList OL_PAIR_LIST O primeiro elemento do par é um deslocamento de 4 bytes, calculado desde o início (deslocamento 0) dessa estrutura MBIM_MS_NETWORK_BLACKLIST_INFO até uma estrutura MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Para obter mais informações, consulte a tabela MBIM_MS_NETWORK_BLACKLIST_PROVIDER. O segundo elemento do par é um tamanho de 4 bytes de um ponteiro para a estrutura de MBIM_MS_NETWORK_BLACKLIST_PROVIDER correspondente.
8 + (8 * EC) DataBuffer DATABUFFER Matriz de estruturas MBIM_MS_NETWORK_BLACKLIST_PROVIDER.

As estruturas de dados a seguir são usadas na tabela anterior.

MBIM_MS_NETWORK_BLACKLIST_STATE descreve os possíveis estados das duas listas negras diferentes.

Tipo Mask Descrição
MbimMsNetworkBlacklistStateNotActuated 0h Ambas as condições da lista negra não são atendidas.
MbimMsNetworkBlacklistSIMProviderActuated 1h O SIM inserido está na lista negra, pois sua ID do Provedor corresponde à lista negra da ID do Provedor do SIM.
MbimMsNetworkBlacklistNetworkProviderActuated 2h As redes disponíveis estão na lista negra, pois suas IDs de Provedor estão na lista negra de ID do Provedor de Rede.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER especifica o provedor da lista negra.

Deslocamento Tamanho Campo Tipo Descrição
0 4 MCC UINT32 Conforme especificado pelo 3GPP, o MCC faz parte do IMSI e especifica o país do provedor.
4 4 MNC UINT32 Conforme especificado por 3GPP, o MNC faz parte do IMSI e especifica a rede do provedor.
8 4 NetworkBlacklistType MBIM_MS_NETWORK_BLACKLIST_TYPE Especifica para qual tipo de lista negra o par MCC/MNC é usado. Para obter mais informações, consulte a tabela MBIM_MS_NETWORK_BLACKLIST_TYPE.

MBIM_MS_NETWORK_BLACKLIST_TYPE é usado pela estrutura de dados anterior. Ele especifica quais das duas listas negras serão usadas.

Tipo Valor Descrição
MbimMsNetworkBlacklistTypeSIM 0 O par MCC/MNC é usado para a lista negra do provedor SIM.
MbimMsNetworkBlacklistTypeNetwork 1 O par MCC/MNC é usado para a lista negra do provedor de rede.

Resposta

Para obter mais informações, consulte a tabela MBIM_MS_NETWORK_BLACKLIST_INFO.

Códigos de status

Para operações de consulta e definição:

Código de status Descrição
MBIM_STATUS_READ_FAILURE A operação falhou porque o dispositivo não pôde recuperar contextos provisionados.
MBIM_STATUS_NO_DEVICE_SUPPORT A operação falhou porque o dispositivo não dá suporte à operação.

Somente para Definir operações:

Código de status Descrição
MBIM_STATUS_INVALID_PARAMETERS A operação falhou devido a parâmetros inválidos.
MBIM_STATUS_WRITE_FAILURE A operação falhou porque a solicitação de atualização não foi bem-sucedida.