MB 網路封鎖清單作業
重要
無偏差通訊
Microsoft 支援多元且包容性的環境。 本文包含無 偏差通訊的 Microsoft 樣式指南 辨識為排除詞彙的參考。 本文中會使用單字或片語來保持一致性,因為它目前會出現在軟體中。 當軟體更新為移除語言時,本文將會更新為一致。
裝置可能需要在各種情況下不要註冊到網路,例如插入特定 SIM 卡時,或裝置不想註冊到特定網路時。 為了解決這些情況,Windows 10版本 1703 新增數據機介面,讓 OS 能夠設定 SIM 卡和網路提供者的封鎖清單。
作業系統可以隨時在數據機中設定 MCC/MNC 配對,以指定不允許裝置註冊的 SIM 卡或網路。 介面彈性足以允許兩個不同的清單、一個用於 SIM 提供者,另一個用於網路提供者。 如果裝置未嘗試註冊,因為特定 SIM 卡或網路提供者已列入封鎖清單,數據機必須將註冊狀態回報為拒絕。
網路封鎖清單作業的 MB 介面更新
已建立新的 MBIM 命令,讓 OS 能夠查詢及設定 MCC 和 MNC 配對,當裝置上有相符的 SIM 卡或網路提供者時,數據機不應該嘗試註冊。 針對此命令,新的 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
描述
企業、使用者或電信業者可以指定他們不想註冊數據機的 SIM 卡和網路。 此命令用於作業系統,以在數據機上查詢和設定封鎖清單。 有兩個封鎖清單:
- SIM 卡封鎖清單 – 其提供者是封鎖清單成員的 SIM 卡,不得在任何網路上註冊。
- 網路提供者封鎖清單 – 不允許在封鎖清單中註冊網路,無論裝置上存在何種 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 應為零。
集合
下列MBIM_MS_NETWORK_BLACKLIST_INFO結構應該用於 InformationBuffer 中。
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
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 | 配對的第一個元素是 4 位元組位移,從這個MBIM_MS_NETWORK_BLACKLIST_INFO結構的開頭 (位移 0) 到MBIM_MS_NETWORK_BLACKLIST_PROVIDER結構。 如需詳細資訊,請參閱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 | 描述 |
---|---|---|
MbimMsNetworkBlacklistStateNotActuated | 0h | 不符合這兩個封鎖清單條件。 |
MbimMsNetworkBlacklistSIMProviderActuated | 1h | 插入的 SIM 卡會列入封鎖清單,因為其提供者識別碼符合 SIM 提供者識別碼的封鎖清單。 |
MbimMsNetworkBlacklistNetworkProviderActuated | 2h | 可用的網路會列入封鎖清單,因為其提供者識別碼全都位於網路提供者識別碼的封鎖清單中。 |
MBIM_MS_NETWORK_BLACKLIST_PROVIDER指定封鎖清單的提供者。
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
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。 它會指定將使用哪兩個封鎖清單。
類型 | 值 | 描述 |
---|---|---|
MbimMsNetworkBlacklistTypeSIM | 0 | MCC/MNC 配對用於 SIM 提供者封鎖清單。 |
MbimMsNetworkBlacklistTypeNetwork | 1 | MCC/MNC 配對用於網路提供者封鎖清單。 |
回應
如需詳細資訊,請參閱MBIM_MS_NETWORK_BLACKLIST_INFO資料表。
狀態碼
針對查詢和設定作業:
狀態碼 | 描述 |
---|---|
MBIM_STATUS_READ_FAILURE | 作業失敗,因為裝置無法擷取布建的內容。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 作業失敗,因為裝置不支援作業。 |
僅適用于設定作業:
狀態碼 | 描述 |
---|---|
MBIM_STATUS_INVALID_PARAMETERS | 作業失敗,因為參數無效。 |
MBIM_STATUS_WRITE_FAILURE | 作業失敗,因為更新要求失敗。 |