IMbnSignal：：GetSignalStrength 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得裝置收到的訊號強度。
語法
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
參數
[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 |