MB ネットワーク ブラックリスト操作

  • [アーティクル]

重要

バイアスフリーなコミュニケーション

Microsoft では、多様性があり、包括的な環境をサポートしています。 この記事には、偏見のないコミュニケーションのための Microsoft スタイル ガイドで排他的と認識される用語への参照が含まれています。 この単語または言い回しは現在ソフトウェアで使われているものであることから、一貫性を保つためにこの記事で使用しています。 対象文言を削除するためにソフトウェアが更新される場合、それに合わせてこの記事も更新されます。

特定の SIM カードが挿入されたときや、デバイスが特定のネットワークへの登録を必要としない場合など、さまざまなシナリオで、デバイスをネットワークに登録しないようにする必要がある場合があります。 このような状況に対処するために、Windows 10 バージョン 1703 では、OS で SIM カードおよびネットワーク プロバイダーのブラックリストを構成できるようにモデム インターフェイスを追加します。

OS では、デバイスの登録が許可されていない SIM またはネットワークを指定するように、モデムの MCC/MNC ペアをいつでも構成できます。 インターフェイスは柔軟性が高く、SIM プロバイダー用とネットワーク プロバイダー用の 2 つの異なるリストを許可できます。 特定の SIM プロバイダーまたはネットワーク プロバイダーがブラックリストに登録されていたためにデバイスが登録を試みなかった場合、モデムは登録状態を拒否として報告する必要があります。

ネットワーク ブラックリスト操作の MB インターフェイスの更新

一致する SIM カードまたはネットワーク プロバイダーがデバイスに存在する場合にモデムが登録を試みるべきではない MCC と MNC のペアについて OS がクエリを実行して設定できるように、新しい MBIM コマンドが作成されました。 このコマンドでは、新しい MSFT 専用 CID が MBIM_CID_MS_NETWORK_BLACKLIST として定義されています。

サービス名 = 基本的な接続拡張機能

UUID = UUID_BASIC_CONNECT_EXTENSIONS

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

CID コマンド コード Minimum OS Version
MBIM_CID_MS_NETWORK_BLACKLIST 2 Windows 10 Version 1703

MBIM_CID_MS_NETWORK_BLACKLIST

説明

企業、ユーザー、または通信事業者は、モデムに登録する必要がない SIM カードとネットワークを指定できます。 このコマンドを使用すると、OS で、ブラックリストに対してクエリを実行し、モデムにブラックリストを設定できます。 次の 2 つのブラックリストがあります。

  1. SIM カード ブラックリスト – プロバイダーがブラックリストに登録されている SIM カードは、どのネットワークへの登録も許されるべきではありません。
  2. ネットワーク プロバイダーブラックリスト - ブラックリストに掲載されているネットワークは、デバイスに存在する SIM カードに関係なく、登録が許されるべきではありません。

モデムは、モデムごとにブラックリストを保持し、SIM スワップと電源サイクルにわたって持続させる必要があります。 どちらのブラックリストも、SIM の状態に関係なく、常に Query または Set を使用してアクセスできます。

Set コマンドの場合、モデム内の既存のブラックリストを Set コマンドのペイロードで上書きすることが想定されています。

クエリ

MBIM_MS_NETWORK_BLACKLIST_INFO は、InformationBuffer で完了した Query メッセージと Set メッセージから返されます。 Query の場合、InformationBuffer は NULL です。

Set

Set の場合、InformationBuffer には MBIM_MS_NETWORK_BLACKLIST_INFO が含まれます。 Set 操作では、MNC/MCC の組み合わせの一覧をモデムに提供する必要があります。 SIM カードの IMSI が指定された MNC と MCC の値と一致している場合、モデムはネットワークから登録を解除し、MNC/MCC と一致しない新しい SIM カードが挿入されるまで再登録を試みることはできません。

要求されていないイベント

SIM プロバイダーブラックリストと一致するプロバイダーの SIM が挿入された場合など、ブラックリストの状態のいずれかが作動状態から非作動状態に変更された場合 (またはその逆の場合) は、Unsolicited Event が想定されます。

パラメーター

操作 Set クエリ 通知
コマンド MBIM_MS_NETWORK_BLACKLIST_INFO 適用なし 適用なし
回答 MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO MBIM_MS_NETWORK_BLACKLIST_INFO

データ構造

クエリ

InformationBuffer は NULL とし、InformationBufferLength は 0 とします。

Set

InformationBuffer では、次のMBIM_MS_NETWORK_BLACKLIST_INFO 構造体を使用する必要があります。

オフセット サイズ フィールド タイプ 説明
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 の表を参照してください。 ペアの 2 番目の要素は、対応するMBIM_MS_NETWORK_BLACKLIST_PROVIDER 構造体へのポインターの 4 バイト サイズです。
8 + (8 * EC) DataBuffer DATABUFFER MBIM_MS_NETWORK_BLACKLIST_PROVIDER 構造体の配列。

前の表では、次のデータ構造が使用されています。

MBIM_MS_NETWORK_BLACKLIST_STATE では、2 つの異なるブラックリストの考えられる状態を記述します。

Type マスク 説明
MbimMsNetworkBlacklistStateNotActuated 0h 両方のブラックリスト条件が満たされていません。
MbimMsNetworkBlacklistSIMProviderActuated 1 時間 挿入された SIM は、プロバイダー ID が SIM プロバイダー ID のブラックリストと一致するため、ブラックリストに登録されています。
MbimMsNetworkBlacklistNetworkProviderActuated 2h 使用可能なネットワークは、プロバイダー ID がネットワーク プロバイダー ID のブラックリストにすべて含まれるため、ブラックリストに登録されています。

MBIM_MS_NETWORK_BLACKLIST_PROVIDER はブラックリストのプロバイダーを指定します。

オフセット サイズ フィールド タイプ 説明
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 は、上記のデータ構造で使用されます。 2 つのブラックリストのうち、どちらを使用するかを指定します。

Type 値 説明
MbimMsNetworkBlacklistTypeSIM 0 MCC/MNC ペアは、SIM プロバイダーのブラックリストに使用されます。
MbimMsNetworkBlacklistTypeNetwork 1 MCC/MNC ペアは、ネットワーク プロバイダーのブラックリストに使用されます。

回答

詳細については、MBIM_MS_NETWORK_BLACKLIST_INFO の表を参照してください。

状態コード

Query 操作と Set 操作の場合:

状態コード 説明
MBIM_STATUS_READ_FAILURE デバイスがプロビジョニングされたコンテキストを取得できなかったため、操作は失敗しました。
MBIM_STATUS_NO_DEVICE_SUPPORT デバイスが操作をサポートしていないため、操作は失敗しました。

Set 操作の場合のみ:

状態コード 説明
MBIM_STATUS_INVALID_PARAMETERS パラメーターが無効なため、操作は失敗しました。
MBIM_STATUS_WRITE_FAILURE 更新要求が失敗したため、操作は失敗しました。