NDIS_WWAN_PREFERRED_PROVIDERS結構(ndiswwan.h)
NDIS_WWAN_PREFERRED_PROVIDERS 結構代表慣用提供者的清單,包括清單中的提供者數目。
語法
typedef struct _NDIS_WWAN_PREFERRED_PROVIDERS {
NDIS_OBJECT_HEADER Header;
WWAN_STATUS uStatus;
WWAN_LIST_HEADER PreferredListHeader;
} NDIS_WWAN_PREFERRED_PROVIDERS, *PNDIS_WWAN_PREFERRED_PROVIDERS;
成員
Header
具有類型、修訂和大小資訊之NDIS_WWAN_PREFERRED_PROVIDERS結構的標頭。 MB 服務會使用下表中顯示的值來設定標頭,此標頭會將數據結構傳送至迷你埠驅動程式,以進行 集 作業。 迷你埠驅動程式在將數據結構傳送至 MB 服務時,必須使用相同的值來設定標頭。
標頭子成員 | 價值 |
---|---|
類型 | NDIS_OBJECT_TYPE_DEFAULT |
校訂 | NDIS_WWAN_PREFERRED_PROVIDERS_REVISION_1 |
大小 | sizeof(NDIS_WWAN_PREFERRED_PROVIDERS) |
如需這些成員的詳細資訊,請參閱 NDIS_OBJECT_HEADER。
uStatus
迷你埠驅動程序必須將此設定為WWAN_STATUS_SUCCESS未經請求的事件(NDIS_STATUS_INDICATION::RequestId = 0)。 WWAN_STATUS_SUCCESS也會設定為成功執行NDIS_WWAN_SET_PREFERRED_PROVIDERS。
下表顯示其他可能的錯誤狀態代碼(迷你埠驅動程式不需要更新其他成員)。
價值 | 意義 |
---|---|
WWAN_STATUS_PIN_REQUIRED | 裝置需要 PIN 值輸入。 |
WWAN_STATUS_READ_FAILURE | 從裝置或 SIM 卡讀取資訊,或兩者都失敗。 例如,SIM 卡沒有布建慣用的提供者資訊。 |
WWAN_STATUS_BAD_SIM | 偵測到錯誤的 SIM 卡。 |
WWAN_STATUS_SIM_NOT_INSERTED | SIM 卡未插入裝置中。 |
WWAN_STATUS_NO_DEVICE_SUPPORT | 不支援 集 要求。 |
PreferredListHeader
格式化 WWAN_LIST_HEADER 物件,代表慣用提供者的清單,包括清單中的提供者數目。
這些會使用 WWAN_LIST_HEADER 結構指向 WWAN_PROVIDER2 清單。 WwanDataClass 旗標描述特定數據存取技術的喜好設定,而且可以設定為自己的行動數據類別內的任何組合。
回應 OID_WWAN_PREFERRED_PROVIDERS 要求必須包含 PreferenceListHeader中的零個專案。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
標頭 | ndiswwan.h (包括 Ndiswwan.h) |