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)

另請參閱

WWAN 封包內容管理