使用SetupAPI在MinGW编译的C程序中检测已配对BLE设备当前连接状态的异常问题

看起来你在通过SetupAPI检测已配对BLE设备的当前连接状态时踩了两个坑：一是DEVPKEY_Device_IsPresent不管设备物理开没开都返回true，二是DEVPKEY_DeviceContainer_IsConnected和DEVPKEY_DeviceContainer_IsPaired直接抛出1168错误（ERROR_NOT_FOUND）。我来帮你拆解下问题根源，再给你两个可行的解决思路。

问题原因分析 #

1. 为什么DEVPKEY_Device_IsPresent总是返回true？ #

你调用SetupDiGetClassDevs时用了DIGCF_PRESENT参数，这个参数筛选的是系统逻辑上认为存在的设备。对于已配对的BLE设备来说，哪怕物理设备已经关机，系统里还保留着它的配对信息和设备节点，所以会一直被标记为“存在”。这个属性本来就不是用来判断设备当前是否物理连接的，它只能说明设备在系统的设备数据库里有记录。

2. 为什么会出现1168错误？ #

DEVPKEY_DeviceContainer_IsConnected和DEVPKEY_DeviceContainer_IsPaired是设备容器的属性，而你现在枚举的是GUID_DEVCLASS_BLUETOOTH类下的单个设备实例。SetupDiGetDevicePropertyW是用来读取单个设备实例属性的，直接用它去读容器级别的属性，系统自然找不到对应的属性项，所以返回ERROR_NOT_FOUND。

可行的解决思路 #

方案1：改用蓝牙原生API（推荐，更精准高效） #

SetupAPI是通用设备管理接口，对于BLE这种有专属协议栈的设备，用Windows提供的蓝牙原生API能更直接、准确地获取连接状态。咱们可以用BluetoothFindFirstDevice/BluetoothFindNextDevice枚举已配对设备，再通过BluetoothGetDeviceInfo拿到设备的实时连接状态——BLUETOOTH_DEVICE_INFO结构体里的fConnected字段就是你要的当前物理连接状态，fPaired还能直接验证配对状态，完全避开SetupAPI的坑。

下面是适配MinGW的示例代码：

#include <Windows.h>
#include <BluetoothAPIs.h>
#include <stdio.h>

// MinGW下编译时需要链接这些库，代码里加pragma注释或者编译时加参数都可以
#pragma comment(lib, "Bthprops.lib")
#pragma comment(lib, "Setupapi.lib")

int main() {
    BLUETOOTH_DEVICE_SEARCH_PARAMS searchParams = {0};
    BLUETOOTH_DEVICE_INFO deviceInfo = {0};
    HBLUETOOTH_DEVICE_FIND hFindDevice = NULL;

    // 初始化搜索参数：只枚举已配对（认证过）的蓝牙设备
    searchParams.dwSize = sizeof(BLUETOOTH_DEVICE_SEARCH_PARAMS);
    searchParams.fReturnAuthenticated = TRUE;
    searchParams.fReturnConnected = FALSE; // 先枚举所有已配对设备，再逐个查连接状态
    searchParams.fReturnRemembered = TRUE;
    searchParams.fReturnUnknown = FALSE;
    searchParams.fIssueInquiry = FALSE; // 不用主动扫描，直接读系统配对列表
    searchParams.cTimeoutMultiplier = 0;

    deviceInfo.dwSize = sizeof(BLUETOOTH_DEVICE_INFO);

    // 开始枚举第一个设备
    hFindDevice = BluetoothFindFirstDevice(&searchParams, &deviceInfo);
    if (hFindDevice == NULL) {
        printf("枚举蓝牙设备失败，错误码：%lu\n", GetLastError());
        return 1;
    }

    // 遍历所有已配对设备
    do {
        wprintf(L"设备名称：%s\n", deviceInfo.szName);
        printf("是否已配对：%s\n", deviceInfo.fPaired ? "是" : "否");
        printf("当前是否连接：%s\n", deviceInfo.fConnected ? "是" : "否");
        printf("-------------------------\n");
    } while (BluetoothFindNextDevice(hFindDevice, &deviceInfo));

    // 释放资源
    BluetoothFindDeviceClose(hFindDevice);
    return 0;
}

MinGW编译命令

编译时需要链接蓝牙和SetupAPI的相关库，执行以下命令即可：

gcc ble_check.c -o ble_check.exe -lsetupapi -lbthprops -lws2_32

方案2：坚持用SetupAPI的话，先获取设备容器ID再查属性 #

如果你一定要基于SetupAPI实现，得先通过设备实例拿到对应的设备容器ID，再用容器ID去查询容器级的属性。步骤会繁琐一些，而且准确性不如蓝牙原生API，这里给你个大致的实现思路：

1. 调用SetupDiGetDevicePropertyW，传入DEVPKEY_Device_ContainerId，获取当前设备实例所属的容器GUID；
2. 调用SetupDiGetDeviceContainerPropertyW，传入这个容器GUID，去读取DEVPKEY_DeviceContainer_IsConnected和DEVPKEY_DeviceContainer_IsPaired属性。

不过说实话，这个方法绕了一大圈，而且对于BLE设备的实时连接状态，还是蓝牙原生API的结果更可靠，所以更推荐你用方案1。

额外注意事项 #

• MinGW环境下要确保头文件路径正确，有些旧版本的MinGW可能需要手动补充蓝牙相关的头文件，如果编译时提示找不到BluetoothAPIs.h，可以去微软官网下载对应的SDK头文件放到MinGW的include目录里。
• 程序不需要管理员权限就能读取蓝牙设备的连接状态，普通用户权限足够。
• 部分低功耗BLE设备在断开连接后会快速进入休眠模式，系统可能有短暂的状态延迟，但蓝牙原生API的fConnected是直接从蓝牙协议栈获取的实时状态，延迟可以忽略不计。

备注：内容来源于stack exchange，提问作者Jonny Schubert