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 정의되었습니다.

서비스 이름 = Basic Connect 확장

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

묘사

기업, 사용자 또는 통신사는 모뎀을 등록하지 않으려는 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을 삽입하는 경우입니다.

매개 변수

수술	설정	쿼리	통지
명령	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에 사용됩니다.

오프셋	크기	필드	유형	묘사
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	블랙리스트제공자참조목록	해당 쌍 목록	쌍의 첫 번째 요소는 이 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	MBIM_MS_NETWORK_BLACKLIST_PROVIDER 구조체의 배열입니다.

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

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

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

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

상쇄	크기	들판	타입	묘사
0	4	MCC	UINT32	3GPP에서 지정한 대로 MCC는 IMSI의 일부이며 공급자의 국가를 지정합니다.
4	4	다국적 기업	UINT32	3GPP에서 지정한 대로 MNC는 IMSI의 일부이며 공급자의 네트워크를 지정합니다.
8	4	네트워크 블랙리스트 유형	MBIM_MS_NETWORK_BLACKLIST_TYPE (네트워크 블랙리스트 유형)	MCC/MNC 쌍이 사용되는 블랙리스트 유형을 지정합니다. 자세한 내용은 MBIM_MS_NETWORK_BLACKLIST_TYPE 테이블을 참조하세요.

MBIM_MS_NETWORK_BLACKLIST_TYPE 이전 데이터 구조에서 사용됩니다. 두 블랙리스트 중 사용할 블랙리스트를 지정합니다.

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

응답

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

상태 코드

쿼리 및 설정 작업의 경우:

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

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

상태 코드	묘사
MBIM_상태_잘못된_매개변수	잘못된 매개 변수로 인해 작업이 실패했습니다.
MBIM_STATUS_WRITE_FAILURE (쓰기 실패)	업데이트 요청이 실패하여 작업이 실패했습니다.