WWAN_PROVIDER結構(wwan.h)
WWAN_PROVIDER 結構代表網路提供者的詳細數據。
語法
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
成員
ProviderId[WWAN_PROVIDERID_LEN]
代表網路提供者身分識別的NULL終止數值 (0-9) 字串。
針對 GSM 型網路,此字串是三位數行動國家 /地區代碼 (MCC) 和兩或三位數行動網路代碼 (MNC) 的串連。 GSM 型電信業者可能有多個 MNC,因此 ProviderId 多個。
針對 CDMA 型網路,此字串是五位數的系統識別碼(SID)。 一般而言,CDMA 型電信業者有多個 SID。 通常,該航空公司針對每個市場都有一個 SID,這通常依法規在一個國家之間劃分,例如美國大都會統計區(MSA)。 CDMA 型裝置的迷你埠驅動程式必須在無法使用此資訊時指定WWAN_CDMA_DEFAULT_PROVIDER_ID。
ProviderState
值,表示網路提供者專案可標記的各種狀態。 下表顯示迷你埠驅動程序應該指定的可能值(可以指定一或多個值)。
價值 | 意義 |
---|---|
WWAN_PROVIDER_STATE_HOME | 網路提供者是主作員。 |
WWAN_PROVIDER_STATE_FORBIDDEN | 網路提供者位於禁止清單中。 |
WWAN_PROVIDER_STATE_PREFERRED | 網路提供者位於慣用清單上。 |
WWAN_PROVIDER_STATE_VISIBLE | 網路提供者是可見的。 |
WWAN_PROVIDER_STATE_REGISTERED | 網路提供者目前由裝置註冊。 |
WWAN_PROVIDER_STATE_UNKNOWN | 網路提供者狀態未知。 |
上表的某些值僅適用於特定物件標識碼(OID)。 下表顯示這些值與相關 OID 之間的關聯。
價值 | OID |
---|---|
WWAN_PROVIDER_STATE_HOME | |
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
ProviderName[WWAN_PROVIDERNAME_LEN]
NULL 終止的字串,表示網路提供者的名稱。 此成員最多只能WWAN_PROVIDERNAME_LEN個字元。
針對 GSM 型網路,如果偏好呈現國家首字母縮寫和行動網路名稱 (PPCI&N) 超過 WWAN_PROVIDERNAME_LEN 個字元,則迷你埠驅動程式應縮寫網路名稱。
當 MB 服務設定慣用的提供者清單時,會忽略此成員。
迷你埠驅動程式應該為沒有這項資訊的裝置指定 NULL 字串。
WwanDataClass
位圖,表示裝置支援的數據類別(es)。 如需值的詳細清單,請參閱 WWAN_DEVICE_CAPS的 WwanDataClass 成員。
查詢OID_WWAN_HOME_PROVIDER時,可以忽略此成員。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
標頭 | wwan.h (包括 Wwan.h) |