MB 네트워크 블랙리스트 작업

중요

바이어스 없는 통신

Microsoft는 다양하고 포괄적인 환경을 지원합니다. 이 문서에는 바이어스 없는 통신을 위한 Microsoft 스타일 가이드 에서 제외로 인식하는 용어에 대한 참조가 포함되어 있습니다. 단어 또는 구는 현재 소프트웨어에 표시되므로 일관성을 위해 이 문서에서 사용됩니다. 언어를 제거하도록 소프트웨어가 업데이트되면 이 문서는 맞춤으로 업데이트됩니다.

특정 SIM 카드 삽입되거나 디바이스가 특정 네트워크에 등록하지 않으려는 경우와 같은 다양한 시나리오에서 디바이스가 네트워크에 등록하지 않도록 요구할 수 있습니다. 이러한 상황을 해결하기 위해 Windows 10 버전 1703은 OS가 SIM 카드 및 네트워크 공급자에 대한 블랙리스트를 구성할 수 있도록 모뎀 인터페이스를 추가합니다.

언제든지 OS는 모뎀에서 MCC/MNC 쌍을 구성하여 디바이스가 등록할 수 없는 SIM 또는 네트워크를 지정할 수 있습니다. 인터페이스는 SIM 공급자용과 네트워크 공급자를 위한 두 개의 서로 다른 목록을 허용할 수 있을 만큼 유연합니다. 특정 SIM 또는 네트워크 공급자가 블랙리스트에 추가되어 디바이스가 등록을 시도하지 않은 경우 모뎀은 등록 상태 거부된 것으로 보고해야 합니다.

네트워크 블랙리스트 작업에 대한 MB 인터페이스 업데이트

OS가 일치하는 SIM 카드 또는 네트워크 공급자가 디바이스에 있을 때 모뎀이 등록을 시도하지 않아야 하는 MCC 및 MNC 쌍을 쿼리하고 설정할 수 있도록 새 MBIM 명령이 만들어졌습니다. 이 명령의 경우 새 MSFT 독점 CID가 MBIM_CID_MS_NETWORK_BLACKLIST 정의되었습니다.

서비스 이름 = 기본 연결 확장

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID	명령 코드	최소 OS 버전
MBIM_CID_MS_NETWORK_BLACKLIST	2	Windows 10, 버전 1703

MBIM_CID_MS_NETWORK_BLACKLIST

Description

기업, 사용자 또는 통신사는 모뎀을 등록하지 않으려는 SIM 카드 및 네트워크를 지정할 수 있습니다. 이 명령은 OS가 모뎀에서 블랙리스트를 쿼리하고 설정할 수 있도록 하는 데 사용됩니다. 다음 두 가지 블랙리스트가 있습니다.

1. SIM 카드 블랙리스트 – 공급자가 블랙리스트의 구성원인 SIM 카드는 네트워크에 등록할 수 없습니다.
2. 네트워크 공급자 블랙리스트 – 블랙리스트의 네트워크는 디바이스에 있는 SIM 카드 관계없이 등록할 수 없습니다.

모뎀은 모뎀당 블랙리스트를 모두 유지하고 SIM 스왑 및 전원 주기에서 유지되어야 합니다. SIM 상태에 관계없이 항상 쿼리 또는 설정을 사용하여 두 블랙리스트에 액세스할 수 있습니다.

Set 명령의 경우 Set 명령의 페이로드를 사용하여 모뎀의 기존 블랙리스트를 덮어씁니다.

쿼리

MBIM_MS_NETWORK_BLACKLIST_INFO 완료된 쿼리 및 InformationBuffer의 메시지 설정에서 반환됩니다. 쿼리의 경우 InformationBuffer는 NULL입니다.

설정

Set의 경우 InformationBuffer에는 MBIM_MS_NETWORK_BLACKLIST_INFO 포함됩니다. 설정 작업에서 MNC/MCC 조합 목록을 모뎀에 제공해야 합니다. SIM 카드 IMSI가 지정된 MNC 및 MCC 값과 일치하는 경우 모뎀은 네트워크에서 등록을 취소해야 하며 MNC/MCC와 일치하지 않는 새 SIM 카드 삽입될 때까지 다시 등록을 시도해서는 안 됩니다.

원치 않는 이벤트

블랙리스트 상태 중에서 작동되지 않음으로 변경되었거나 그 반대로 변경된 경우 원치 않는 이벤트가 예상됩니다. 예를 들어 공급자가 SIM 공급자 블랙리스트와 일치하는 SIM이 삽입된 경우입니다.

매개 변수

작업(Operation)	설정	쿼리	알림
명령	MBIM_MS_NETWORK_BLACKLIST_INFO	해당 없음	해당 없음
응답	MBIM_MS_NETWORK_BLACKLIST_INFO	MBIM_MS_NETWORK_BLACKLIST_INFO	MBIM_MS_NETWORK_BLACKLIST_INFO

데이터 구조

쿼리

InformationBuffer는 NULL이어야 하며 InformationBufferLength는 0이어야 합니다.

설정

다음 MBIM_MS_NETWORK_BLACKLIST_INFO 구조는 InformationBuffer에서 사용해야 합니다.

Offset	크기	필드	형식	Description
0	4	BlacklistState	MBIM_MS_NETWORK_BLACKLIST_STATE	모뎀이 네트워크에 등록되지 않는 블랙리스트 조건이 충족되는지 여부를 나타냅니다. 자세한 내용은 MBIM_MS_NETWORK_BLACKLIST_STATE 테이블을 참조하세요.
4	4	ElementCount(EC)	Uint32	DataBuffer에서 이어지는 MBIM_MS_NETWORK_BLACKLIST_PROVIDER 구조체의 수입니다.
8	8 * EC	BlacklistProviderRefList	OL_PAIR_LIST	쌍의 첫 번째 요소는 이 MBIM_MS_NETWORK_BLACKLIST_INFO 구조체의 시작(오프셋 0)에서 MBIM_MS_NETWORK_BLACKLIST_PROVIDER 구조로 계산된 4 바이트 오프셋입니다. 자세한 내용은 MBIM_MS_NETWORK_BLACKLIST_PROVIDER 테이블을 참조하세요. 쌍의 두 번째 요소는 해당 MBIM_MS_NETWORK_BLACKLIST_PROVIDER 구조체에 대한 포인터의 4 바이트 크기입니다.
8 + (8 * EC)		DataBuffer	DATABUFFER	MBIM_MS_NETWORK_BLACKLIST_PROVIDER 구조체의 배열입니다.

다음 데이터 구조는 앞의 표에서 사용됩니다.

MBIM_MS_NETWORK_BLACKLIST_STATE 두 개의 다른 블랙리스트의 가능한 상태를 설명합니다.

형식	Mask	Description
MbimMsNetworkBlacklistStateNotActuated	0h	두 블랙리스트 조건이 모두 충족되지 않습니다.
MbimMsNetworkBlacklistSIMProviderActuated	1시간	삽입된 SIM은 공급자 ID가 SIM 공급자 ID의 블랙리스트와 일치하기 때문에 블랙리스트에 추가됩니다.
MbimMsNetworkBlacklistNetworkProviderActuated	2h	사용 가능한 네트워크는 공급자 ID가 모두 네트워크 공급자 ID에 대한 블랙리스트에 있으므로 블랙리스트에 포함됩니다.

MBIM_MS_NETWORK_BLACKLIST_PROVIDER 블랙리스트의 공급자를 지정합니다.

Offset	크기	필드	형식	Description
0	4	Mcc	Uint32	3GPP에서 지정한 대로 MCC는 IMSI의 일부이며 공급자의 국가를 지정합니다.
4	4	Mnc	Uint32	3GPP에서 지정한 대로 MNC는 IMSI의 일부이며 공급자의 네트워크를 지정합니다.
8	4	NetworkBlacklistType	MBIM_MS_NETWORK_BLACKLIST_TYPE	MCC/MNC 쌍이 사용되는 블랙리스트 유형을 지정합니다. 자세한 내용은 MBIM_MS_NETWORK_BLACKLIST_TYPE 테이블을 참조하세요.

MBIM_MS_NETWORK_BLACKLIST_TYPE 이전 데이터 구조에서 사용됩니다. 사용할 두 개의 블랙리스트 중 어느 것을 지정합니다.

형식	값	Description
MbimMsNetworkBlacklistTypeSIM	0	MCC/MNC 쌍은 SIM 공급자 블랙리스트에 사용됩니다.
MbimMsNetworkBlacklistTypeNetwork	1	MCC/MNC 쌍은 네트워크 공급자 블랙리스트에 사용됩니다.

응답

자세한 내용은 MBIM_MS_NETWORK_BLACKLIST_INFO 테이블을 참조하세요.

상태 코드

쿼리 및 설정 작업의 경우:

상태 코드	Description
MBIM_STATUS_READ_FAILURE	디바이스가 프로비전된 컨텍스트를 검색할 수 없어 작업이 실패했습니다.
MBIM_STATUS_NO_DEVICE_SUPPORT	디바이스가 작업을 지원하지 않으므로 작업이 실패했습니다.

설정 작업의 경우에만 다음을 수행합니다.

상태 코드	Description
MBIM_STATUS_INVALID_PARAMETERS	잘못된 매개 변수로 인해 작업이 실패했습니다.
MBIM_STATUS_WRITE_FAILURE	업데이트 요청이 실패하여 작업이 실패했습니다.