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 つのブラックリストがあります。
- SIM カード ブラックリスト – プロバイダーがブラックリストに登録されている SIM カードは、どのネットワークへの登録も許されるべきではありません。
- ネットワーク プロバイダーブラックリスト - ブラックリストに掲載されているネットワークは、デバイスに存在する 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 | 更新要求が失敗したため、操作は失敗しました。 |