Operaciones de lista negra de red mb
Importante
Comunicación sin prejuicios
Microsoft admite un entorno diverso e inclusivo. Este artículo contiene referencias a la terminología que la guía de estilo de Microsoft para la comunicación sin sesgo reconoce como excluyente. La palabra o frase se usa en este artículo para la coherencia porque actualmente aparece en el software. Cuando el software se actualice para quitar el idioma, este artículo se actualizará para que esté en alineación.
Es posible que un dispositivo no se registre en una red en varios escenarios, como cuando se inserta una tarjeta SIM específica o si un dispositivo no desea registrarse en una red específica. Para abordar estas situaciones, Windows 10, versión 1703 está agregando interfaces de módem para permitir que el sistema operativo configure listas negras para tarjetas SIM y proveedores de red.
En cualquier momento, el sistema operativo puede configurar el par MCC/MNC en el módem para especificar la SIM o la red a la que el dispositivo no puede registrarse. La interfaz es lo suficientemente flexible como para permitir dos listas diferentes, una para proveedores SIM y otra para proveedores de red. Si el dispositivo no intentó el registro porque un proveedor de red o SIM determinado estaba en la lista negra, el módem debe notificar el estado de registro como denegado.
Actualización de la interfaz MB para las operaciones de la lista negra de red
Se ha creado un nuevo comando MBIM para permitir que el sistema operativo consulte y establezca el par MCC y MNC con el que el módem no debe intentar el registro cuando haya una tarjeta SIM o un proveedor de red coincidentes en el dispositivo. Para este comando, se ha definido un nuevo CID propietario de MSFT como MBIM_CID_MS_NETWORK_BLACKLIST.
Nombre del servicio = Extensiones básicas de Connect
UUID = UUID_BASIC_CONNECT_EXTENSIONS
Valor UUID = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | Código de comando | Versión mínima del sistema operativo |
|---|---|---|
| MBIM_CID_MS_NETWORK_BLACKLIST | 2 | Windows 10, versión 1703 |
MBIM_CID_MS_NETWORK_BLACKLIST
Descripción
Las empresas, usuarios o operadores móviles pueden especificar las tarjetas SIM y las redes en las que no quieren que el módem se registre. Este comando se usa para que el sistema operativo pueda consultar y establecer las listas negras en el módem. Hay dos listas negras:
- Una lista negra de tarjetas SIM: tarjetas SIM cuyo proveedor es miembro de la lista negra no debe poder registrarse en ninguna red.
- Una lista negra del proveedor de red: no se debe permitir que las redes de la lista negra se registren independientemente de qué tarjeta SIM esté presente en el dispositivo.
El módem tiene que mantener las listas negras por módem y conservarse en los intercambios sim y los ciclos de energía. Se puede acceder a ambas listas negras con Query o Set en todo momento, independientemente del estado sim.
Para el comando Set, se espera que sobrescriba las listas negras existentes en el módem con la carga del comando Set.
Consultar
MBIM_MS_NETWORK_BLACKLIST_INFO se devuelve de los mensajes Query y Set completados en InformationBuffer. En Consulta, InformationBuffer es NULL.
Set
Para Set, InformationBuffer contiene un MBIM_MS_NETWORK_BLACKLIST_INFO. En la operación Set, se debe proporcionar una lista de combinaciones de MNC/MCC al módem. Cuando el IMSI de la tarjeta SIM coincide con el valor MNC y MCC especificado, el módem debe anular el registro de la red y no debe intentar volver a registrar hasta que se inserte una nueva tarjeta SIM que no coincida con el MNC/MCC.
Evento no solicitado
Se espera un evento no solicitado si alguno de los estados de la lista negra ha cambiado de accionado a no accionado, o viceversa; por ejemplo, si se inserta una SIM cuyo proveedor coincide con la lista negra del proveedor sim.
Parámetros
| Operación | Set | Consultar | notificación |
|---|---|---|---|
| Get-Help | MBIM_MS_NETWORK_BLACKLIST_INFO | No aplicable | No aplicable |
| Response | MBIM_MS_NETWORK_BLACKLIST_INFO | MBIM_MS_NETWORK_BLACKLIST_INFO | MBIM_MS_NETWORK_BLACKLIST_INFO |
Estructuras de datos
Consultar
InformationBuffer será NULL y InformationBufferLength será cero.
Set
La siguiente estructura MBIM_MS_NETWORK_BLACKLIST_INFO se usará en informationBuffer.
| Offset | Size | Campo | Tipo | Descripción |
|---|---|---|---|---|
| 0 | 4 | BlacklistState | MBIM_MS_NETWORK_BLACKLIST_STATE | Indica si se cumple alguna de las condiciones de la lista negra que dan lugar a que el módem no se registre en la red. Para obtener más información, consulte la tabla MBIM_MS_NETWORK_BLACKLIST_STATE. |
| 4 | 4 | ElementCount (EC) | UINT32 | Recuento de estructuras de MBIM_MS_NETWORK_BLACKLIST_PROVIDER que siguen en DataBuffer. |
| 8 | 8 * CE | BlacklistProviderRefList | OL_PAIR_LIST | El primer elemento del par es un desplazamiento de 4 bytes, calculado desde el principio (desplazamiento 0) de esta estructura de MBIM_MS_NETWORK_BLACKLIST_INFO hasta una estructura de MBIM_MS_NETWORK_BLACKLIST_PROVIDER. Para obtener más información, consulte la tabla MBIM_MS_NETWORK_BLACKLIST_PROVIDER. El segundo elemento del par es un tamaño de 4 bytes de un puntero a la estructura MBIM_MS_NETWORK_BLACKLIST_PROVIDER correspondiente. |
| 8 + (8 * CE) | DataBuffer | DATABUFFER | Matriz de estructuras de MBIM_MS_NETWORK_BLACKLIST_PROVIDER. |
Las siguientes estructuras de datos se usan en la tabla anterior.
MBIM_MS_NETWORK_BLACKLIST_STATE describe los posibles estados de las dos listas negras diferentes.
| Tipo | Máscara | Descripción |
|---|---|---|
| MbimMsNetworkBlacklistStateNotActuated | 0h | No se cumplen ambas condiciones de la lista negra. |
| MbimMsNetworkBlacklistSIMProviderActuated | 1h | La SIM insertada está en la lista negra, ya que su identificador de proveedor coincide con la lista negra para el identificador del proveedor de SIM. |
| MbimMsNetworkBlacklistNetworkProviderActuated | 2h | Las redes disponibles están en la lista negra, ya que sus identificadores de proveedor están en la lista negra para el identificador del proveedor de red. |
MBIM_MS_NETWORK_BLACKLIST_PROVIDER especifica el proveedor de la lista negra.
| Offset | Size | Campo | Tipo | Descripción |
|---|---|---|---|---|
| 0 | 4 | MCC | UINT32 | Como se especifica en 3GPP, MCC forma parte de IMSI y especifica el país del proveedor. |
| 4 | 4 | MNC | UINT32 | Como se especifica en 3GPP, MNC forma parte de IMSI y especifica la red del proveedor. |
| 8 | 4 | NetworkBlacklistType | MBIM_MS_NETWORK_BLACKLIST_TYPE | Especifica para qué tipo de lista negra se usa el par MCC/MNC. Para obtener más información, consulte la tabla MBIM_MS_NETWORK_BLACKLIST_TYPE. |
MBIM_MS_NETWORK_BLACKLIST_TYPE usa la estructura de datos anterior. Especifica cuál de las dos listas negras se usará.
| Tipo | Valor | Descripción |
|---|---|---|
| MbimMsNetworkBlacklistTypeSIM | 0 | El par MCC/MNC se usa para la lista negra del proveedor sim. |
| MbimMsNetworkBlacklistTypeNetwork | 1 | El par MCC/MNC se usa para la lista negra del proveedor de red. |
Response
Para obtener más información, consulte la tabla MBIM_MS_NETWORK_BLACKLIST_INFO.
Códigos de estado
Para las operaciones De consulta y establecimiento:
| Código de estado | Descripción |
|---|---|
| MBIM_STATUS_READ_FAILURE | Error en la operación porque el dispositivo no pudo recuperar contextos aprovisionados. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | Error en la operación porque el dispositivo no admite la operación. |
Solo para establecer operaciones:
| Código de estado | Descripción |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | Error en la operación debido a parámetros no válidos. |
| MBIM_STATUS_WRITE_FAILURE | Error en la operación porque la solicitud de actualización no se realizó correctamente. |