OID_WWAN_PROVISIONED_CONTEXTS讀取或更新儲存在 MB 裝置或訂閱者識別模組 (SIM) 上所布建的內容專案。
迷你埠驅動程式必須以異步方式處理設定和查詢要求,一開始傳回原始要求NDIS_STATUS_INDICATION_REQUIRED,然後傳送包含 NDIS_WWAN_PROVISIONED_CONTEXTS 結構 NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS 狀態通知,以提供儲存在 MB 裝置或訂閱者識別模組 (SIM) 上布建內容專案的相關信息,而不論完成設定或查詢要求。
言論
如需使用此 OID 的詳細資訊,請參閱 WWAN 封包內容管理。
如果支援的 MB 裝置不支援擷取布建的內容,迷你埠驅動程式應該會傳回NDIS_STATUS_NOT_SUPPORTED。
GSM 型裝置可以選擇性地支援查詢和設定作業。 CDMA 型裝置可以選擇性地支援報告簡單IP的查詢作業(WWAN_CTRL_CAPS_CDMA_SIMPLE_IP)。
儲存在 MB 裝置或 SIM 卡上的佈建內容專案是裝置的本機內容專案。 迷你埠驅動程式不應該連線到網路,以在這些欄位中讀取。
設定要求的輸入結構是NDIS_WWAN_SET_PROVISIONED_CONTEXT,而此物件的狀態指示NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS。
布建的內容與 3GPP 中快取 APN 清單的 GPRS 內容定義不同。 布建的內容是由作員預先布建的聯機參數(AccessString、UserName 和 Password),或裝置佈建的 OTA,而且可以儲存在裝置記憶體或 SIM 卡中。 布建內容所傳回的連線參數將由 MB 服務用於 PDP 啟用。
會使用這個 對象的查詢和設定形式。
處理此要求不需要網路存取,但需要存取 MB 裝置上的 SIM 卡或輔助記憶體。
迷你埠驅動程式會將NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS通知傳送至作系統。 ContextListHeader.ElementType 成員應設定為 WwanStructContext。 Miniport 驅動程式應該在回應設定要求時,將 ContextListHeader.ElementCount 成員設定為 0。
MB 服務應該先從裝置擷取布建的內容清單,再進行任何個別的內容啟用或停用。 即使裝置可以儲存多個網路提供者內容,布建的內容清單也必須限制為家庭提供者網路。 即使漫遊,內容清單也必須是家庭提供者網路特定的。
SET OID_WWAN_PROVISIONED_CONTEXT作業應該將內容與 ProviderId 中設定要求中指定的網路提供者產生關聯,WWAN_SET_CONTEXT 結構的成員。 透過設定OID_WWAN_PROVISIONED_CONTEXT要求所儲存的已布建內容必須在系統重新啟動和裝置電源回收之間保存。
所有空白內容都必須在查詢上報告,以及適用於家庭提供者網路的布建內容。
針對 SimpleIP 設定的 CDMA 裝置,在 WwanControlCaps 中的 WWAN_CTRL_CAPS_CDMA_SIMPLE_IP 中報告,可以選擇性地傳回至少一個填入正確 AccessString的布建內容、UserName,以及 MB 服務查詢要求的密碼 成員。
布建的內容清單應在裝置中預先布建、藉由設定OID_WWAN_PROVISIONED_CONTEXT作業進行更新,或使用SMS或 OTA 由裝置/作員更新。 它不得根據 MB 服務OID_WWAN_CONNECT作業中提供的內容信息動態更新。
如需如何從 MB 裝置存取清單中每個佈建內容之 AccessString、UserName 和 Password 的詳細資訊,請參閱 WWAN_CONTEXT。
要求
版本 |
適用於 Windows 7 和更新版本的 Windows。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |