MBN_INTERFACE_CAPS結構 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。
MBN_INTERFACE_CAPS 結構代表介面功能。 這個結構是由 IMbnInterface 的 GetInterfaceCapability 方法傳回。
語法
typedef struct MBN_INTERFACE_CAPS {
MBN_CELLULAR_CLASS cellularClass;
MBN_VOICE_CLASS voiceClass;
ULONG dataClass;
BSTR customDataClass;
ULONG gsmBandClass;
ULONG cdmaBandClass;
BSTR customBandClass;
ULONG smsCaps;
ULONG controlCaps;
BSTR deviceID;
BSTR manufacturer;
BSTR model;
BSTR firmwareInfo;
} MBN_INTERFACE_CAPS;
成員
cellularClass
MBN_CELLULAR_CLASS值，指定裝置所使用的行動數據技術。
voiceClass
MBN_VOICE_CLASS值，指定語音通話的處理方式。
dataClass
MBN_DATA_CLASS值的位元組 OR 組合，指定支援哪些資料服務。 針對 GSM 裝置，只有 GSM 型數據服務可以存在，也就是只有 GPRS、EDGE、UMTS、LTE 和 HSDPA 是 GSM 裝置的有效值。
對於 CDMA 裝置，只有 CDMA 相關數據服務存在，也就是說，CDMA 裝置只有 1xRTT、1xEV-DO 和 1xEV-DO RevA 是 CDMA 裝置的有效值。 1xEV-DO RevB 保留供日後使用。
如果裝置也支援在列舉中未定義的某些其他數據類別，此欄位元元會設定 位值MBN_DATA_CLASS_CUSTOM 設定。 如果 已設定MBN_DATA_CLASS_CUSTOM ，則 customDataClass 欄位中會提供自定義數據類別的相關信息。
customDataClass
包含自訂數據類別的名稱。 如果未設定 dataClass MBN_DATA_CLASS_CUSTOM位，則字串為 NULL。 否則，呼叫端必須呼叫 SysFreeString 來釋放此字串。
gsmBandClass
位欄位欄位，指定 GSM 裝置所支援的頻率帶。 透過MBN_BAND_CLASS_X和MBN_BAND_CLASS_CUSTOM MBN_BAND_CLASS_I都是有效的值。 這些值是由 MBN_BAND_CLASS所定義。 如果 gsmBandClass 設定為 MBN_BAND_CLASS_CUSTOM，則有關訊號類別的其他資訊會出現在 customBandClass 中。
下表提供 MBN_BAND_CLASS 值的其他資訊。
| MBN_BAND_CLASS值 | 指定的頻譜 | 產業名稱 | 將 MS 上行連結 (至 BTS) | 將 BTS 下行連結 (至 MS) | 區域 |
|---|---|---|---|---|---|
| MBN_BAND_CLASS_I | UMTS2100 | Imt | 1920-1980 | 2110-2170 | 歐洲、韓國、日本中國 |
| MBN_BAND_CLASS_II | UMT21900 | PCS1900 | 1850-1910 | 1930-1990 | 北美洲、拉丁 |
| MBN_BAND_CLASS_III | UMTS1800 | DCS1800 | 1710-1785 | 1805-1880 | 歐洲、中國 |
| MBN_BAND_CLASS_IV | AWS | AWS，1.7/2.1 | 1710-1785 | 2110-2155 | 北美洲、拉丁 |
| MBN_BAND_CLASS_V | UMTS850 | GSM850 | 824-849 | 869-894 | 北美洲、拉丁 |
| MBN_BAND_CLASS_VI | UMTS800 | UMTS800 | 830-840 | 875-885 | 日本 |
| MBN_BAND_CLASS_VII | UMTS2600 | UMTS2600 | 2500-2570 | 2620-2690 | 歐洲 |
| MBN_BAND_CLASS_VIII | UMTS900 | EGSM900 | 880-915 | 925-960 | 歐洲、中國 |
| MBN_BAND_CLASS_IX | UMTS1700 | UMTS1700 | 1750-1770 | 1845-1880 | 日本 |
| MBN_BAND_CLASS_X | 1710-1770 | 2110-2170 |
cdmaBandClass
指定CDMA裝置所支援頻率帶的位欄位元。 透過MBN_BAND_CLASS_XVII、MBN_BAND_CLASS_NONE和MBN_BAND_CLASS_CUSTOM MBN_BAND_CLASS_0都是有效的值。 這些值是由 MBN_BAND_CLASS所定義。 如果 cdmaBandClass 設定為 MBN_BAND_CLASS_CUSTOM，則有關訊號類別的其他資訊會出現在 customBandClass 中。
下表提供MBN_BAND_CLASS值的其他資訊。
| MBN_BAND_CLASS值 | 產業名稱 | 將 MS 上行連結 (至 BTS) | 將 BTS 下行連結 (至 MS) |
|---|---|---|---|
| MBN_BAND_CLASS_0 | 800MHx 行動數據 | 824.025.844.995 | 869.025.889.995 |
| MBN_BAND_CLASS_I | 1900MHz 帶 | 1850-1910 | 1930-1990 |
| MBN_BAND_CLASS_II | TACS 帶狀 | 872.025.914.9875 | 917.0125.959.9875 |
| MBN_BAND_CLASS_III | JTACS 帶狀 | 887.0125.924.9875 | 832.0125.869.9875 |
| MBN_BAND_CLASS_IV | 韓文 PCS 頻外 | 1750-1780 | 1840-1870 |
| MBN_BAND_CLASS_V | 450 MHz 帶 | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_VI | 2 GHz 帶 | 1920-1979.950 | 2110-2169.950 |
| MBN_BAND_CLASS_VII | 700 MHz 帶 | 776-794 | 746-764 |
| MBN_BAND_CLASS_VIII | 1800 MHz 帶 | 1710-1784.950 | 1805-1879.95 |
| MBN_BAND_CLASS_IX | 900 MHz 帶 | 880-914-950 | 925-959.950 |
| MBN_BAND_CLASS_X | 次要 800 MHz 帶 | 806-900.975 | 851-939.975 |
| MBN_BAND_CLASS_XI | 400 MHz 歐洲 PAMR 帶 | 410-483.475 | 420-493.475 |
| MBN_BAND_CLASS_XII | 800 MHz PAMR 帶 | 870.125-875.9875 | 915.0125-920.9875 |
| MBN_BAND_CLASS_XIII | 2.5 GHz IMT200 延伸模組帶 | 2500-2570 | 2620-2690 |
| MBN_BAND_CLASS_XIV | US PCS 1.9 GHz 帶 | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | AWS 頻外 | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | US 2.5 GHz 帶 | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | 僅限美國 2.5 GHz 轉寄連結帶 | 2624-2690 |
customBandClass
包含自定義帶類別的名稱。 如果未設定 cdmaBandClass 和 gsmBandClassMBN_BAND_CLASS_CUSTOM位，則字串為 NULL。 否則，呼叫端必須呼叫 SysFreeString 來釋放此字串。
smsCaps
指定SMS功能的 MBN_SMS_CAPS 值的位元組 OR 組合。
controlCaps
MBN_CTRL_CAPS值的位元組 OR 組合，表示這個介面的行動寬頻控制功能。
deviceID
包含裝置識別碼。 針對 GSM 裝置，這必須是 IMEI (最多 15 位數) 。 針對 CDMA 裝置，這必須是 ESN (11 位數) /MEID (17 位數) 。 字串的最大長度為 MBN_DEVICEID_LEN。 如需 MBN_DEVICEID_LEN的定義，請參閱 MBN_INTERFACE_CAPS_CONSTANTS。 呼叫端必須呼叫 SysFreeString 來釋放此字串。
manufacturer
包含裝置製造商的名稱。 此字串可以是空的。 字串的最大長度是 MBN_MANUFACTURER_LEN。 如需 MBN_MANUFACTURER_LEN的定義，請參閱 MBN_INTERFACE_CAPS_CONSTANTS。 呼叫端必須呼叫 SysFreeString 來釋放此字串。
model
包含裝置型號。 此字串可以是空的。 此字串的最大長度為 MBN_MODEL_LEN。 如需 MBN_MODEL_LEN的定義，請參閱 MBN_INTERFACE_CAPS_CONSTANTS。 呼叫端必須呼叫 SysFreeString 來釋放此字串。
firmwareInfo
包含此裝置的韌體特定資訊。 此字串可以是空的。 字串的最大長度 為 MBN_FIRMWARE_LEN。 如需 MBN_FIRMWARE_LEN的定義，請參閱 MBN_INTERFACE_CAPS_CONSTANTS。 呼叫端必須呼叫 SysFreeString 來釋放此字串。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 標頭 | mbnapi.h |