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
位圖,表示裝置支援的數據類別 () 。 如需值的詳細清單,請參閱 WWAN_DEVICE_CAPS 的 WwanDataClass 成員。
查詢OID_WWAN_HOME_PROVIDER時,可以忽略這個成員。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows 7 和更新版本的 Windows 中使用。 |
標頭 | wwan.h (包含 Wwan.h) |