OID_WWAN_PROVISIONED_CONTEXTS
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作業應該將內容與WWAN_SET_CONTEXT 結構 之 ProviderId 成員中設定要求中指定的網路提供者產生關聯。 透過設定OID_WWAN_PROVISIONED_CONTEXT要求所儲存的布建內容,必須在系統重新開機和裝置電源回收之間保存。
所有空白內容都必須在查詢上報告,以及適用于家庭提供者網路的布建內容。
針對 SimpleIP 設定的 CDMA 裝置,在 WwanControlCaps 中的WWAN_CTRL_CAPS_CDMA_SIMPLE_IP中報告,可以選擇性地傳回至少一個布建的內容,這些內容會填入來自 MB 服務的查詢要求的正確 AccessString、 UserName和 Password 成員。
布建的內容清單應該在裝置中預先布建、設定OID_WWAN_PROVISIONED_CONTEXT作業來更新,或使用 SMS 或 OTA 由裝置/操作員更新。 它不得根據 MB 服務OID_WWAN_CONNECT作業中提供的內容資訊動態更新。
如需如何從 MB 裝置針對清單中每個布建內容存取 AccessString、UserName 和 Password 的詳細資訊,請參閱 WWAN_CONTEXT。
規格需求
版本 |
可在 Windows 7 和更新版本的 Windows 中使用。 |
標頭 |
Ntddndis.h (包括 Ndis.h) |