IMbnSignal：：GetSignalStrength 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的 Windows 运行时 API。
获取设备接收的信号强度。
语法
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
parameters
[out, retval] signalStrength
指向设备接收的信号质量的指针。 当信号强度未知或设备无法检测到时，此值设置为 MBN_RSSI_UNKNOWN。 如果此方法返回除 S_OK 以外的任何值，则此参数为 0。
返回值
此方法可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
该方法已成功完成。 |
|
信号质量不可用。 移动宽带服务当前正在探测设备以检索此信息。 当信号质量可用时，移动宽带服务将调用 IMbnSignalEvents 的 OnSignalStateChange 方法。 |
注解
GetSignalStrength 报告移动宽带设备收到的信号强度。 对于基于 GSM 的设备，它将信号强度报告为编码值中收到的信号强度。 对于 CDMA 设备，它基于补偿 RSSI (报告噪音) ，而不是基于原始 RSSI。
下表包含可能返回的编码值。
| dBm) 中的信号强度 ( | 编码值 (最小值：0 最大值：31) |
|---|---|
| -113 或更小 | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 或更高 | 31 |
| 未知或无法检测到 | MBN_RSSI_UNKNOWN |
对于 E_MBN_PIN_REQUIRED和 E_MBN_RADIO_POWER_OFF可恢复的错误，移动宽带服务将在错误条件结束时再次查询设备的信号状态。 此方法将返回E_PENDING，直到查询操作完成。 新查询完成后，移动宽带服务将调用 IMbnSignalEvents 的 OnSignalStateChange 方法。
要求
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | mbnapi.h |