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