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) |