共用方式為


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 卡和網路。 此命令用於作業系統,以在數據機上查詢和設定封鎖清單。 有兩個封鎖清單:

  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 應為零。

集合

下列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 作業失敗,因為更新要求失敗。