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 相关的数据服务，即只有 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_I 到 MBN_BAND_CLASS_X 和 MBN_BAND_CLASS_CUSTOM 是有效值。 这些值由 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_0 到 MBN_BAND_CLASS_XVII、 MBN_BAND_CLASS_NONE和 MBN_BAND_CLASS_CUSTOM 都是有效值。 这些值由 MBN_BAND_CLASS 定义。 如果 cdmaBandClass 设置为 MBN_BAND_CLASS_CUSTOM，则有关 band 类的其他信息将显示在 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 | 美国 PCS 1.9 GHz 频带 | 1850-1915 | 1930-1995 |
| MBN_BAND_CLASS_XV | AWS Band | 1710-1755 | 2110-2155 |
| MBN_BAND_CLASS_XVI | 美国 2.5 GHz 频带 | 2502-2568 | 2624-2690 |
| MBN_BAND_CLASS_XVII | 仅美国 2.5 GHz 正向链路带 | 2624-2690 |
customBandClass
包含自定义带类的名称。 如果未设置 cdmaBandClass 和 gsmBandClass的MBN_BAND_CLASS_CUSTOM位，则字符串为 NULL。 否则，调用方必须通过调用 SysFreeString 释放此字符串。
smsCaps
指定 SMS 功能的 MBN_SMS_CAPS 值的按位 OR 组合。
controlCaps
MBN_CTRL_CAPS值的按位 OR 组合，表示此接口的移动宽带控制功能。
deviceID
包含设备 ID。 对于 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 |