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)

另請參閱

NDIS_OBJECT_HEADER

WWAN_LIST_HEADER