C#调用WinAPI的BluetoothFindFirstDevice无结果求助

核心错误点分析 #

1. 未初始化BLUETOOTH_DEVICE_INFO的dwSize字段 #

WinAPI要求所有传入的结构体必须设置dwSize为结构体实际大小，你仅初始化了BLUETOOTH_DEVICE_SEARCH_PARAMS的dwSize，但完全未设置deviceInfo的dwSize，这会导致API无法正确解析结构体，直接返回失败。

2. 结构体定义存在布局/类型不匹配 #

C#结构体必须严格匹配WinAPI的内存布局，需注意以下几点：

• 结构体需添加[StructLayout(LayoutKind.Sequential, Pack = 4)]属性（蓝牙API通常采用4字节对齐）
• WinAPI中的BOOL类型对应C#的int，而非bool；若使用bool需添加[MarshalAs(UnmanagedType.Bool)]属性
• BLUETOOTH_DEVICE_SEARCH_PARAMS的dwSize不应硬编码为248，正确做法是用Marshal.SizeOf(typeof(BLUETOOTH_DEVICE_SEARCH_PARAMS))动态获取适配系统的大小

3. DllImport的库可能存在兼容性问题 #

虽然irprops.cpl可调用蓝牙API，但更推荐使用专用的bthprops.cpl，部分系统环境下irprops.cpl的导出存在兼容性问题。

修正后的代码示例 #

正确的结构体定义 #

[StructLayout(LayoutKind.Sequential, Pack = 4)]
public struct BLUETOOTH_DEVICE_SEARCH_PARAMS
{
    public int dwSize;
    public int fIssueInquiry;
    public int fReturnAuthenticated;
    public int fReturnConnected;
    public int fReturnRemembered;
    public int fReturnUnknown;
    public IntPtr hRadio;
    public int cTimeoutMultiplier;
}

[StructLayout(LayoutKind.Sequential, Pack = 4, CharSet = CharSet.Unicode)]
public struct BLUETOOTH_DEVICE_INFO
{
    public int dwSize;
    public long Address;
    public int ulClassofDevice;
    public int fConnected;
    public int fRemembered;
    public int fAuthenticated;
    public System.Runtime.InteropServices.ComTypes.FILETIME stLastSeen;
    public System.Runtime.InteropServices.ComTypes.FILETIME stLastUsed;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 248)]
    public string szName;
}

修正后的调用代码 #

[DllImport("bthprops.cpl", SetLastError = true, CharSet = CharSet.Unicode)]
static extern IntPtr BluetoothFindFirstDevice(ref BLUETOOTH_DEVICE_SEARCH_PARAMS searchParams, ref BLUETOOTH_DEVICE_INFO deviceInfo);

// 初始化参数
BLUETOOTH_DEVICE_SEARCH_PARAMS param = new BLUETOOTH_DEVICE_SEARCH_PARAMS();
param.dwSize = Marshal.SizeOf(typeof(BLUETOOTH_DEVICE_SEARCH_PARAMS));
param.fIssueInquiry = 1;
param.fReturnAuthenticated = 1;
param.fReturnConnected = 1;
param.fReturnRemembered = 1;
param.fReturnUnknown = 1;
param.hRadio = IntPtr.Zero;
param.cTimeoutMultiplier = 1;

BLUETOOTH_DEVICE_INFO deviceInfo = new BLUETOOTH_DEVICE_INFO();
deviceInfo.dwSize = Marshal.SizeOf(typeof(BLUETOOTH_DEVICE_INFO));

IntPtr handle = BluetoothFindFirstDevice(ref param, ref deviceInfo);

// 检查错误
if (handle == IntPtr.Zero)
{
    int errorCode = Marshal.GetLastWin32Error();
    // 根据错误码排查：比如10022表示参数错误，87表示无效参数，2表示库路径错误
}

额外排查点 #

• 确保程序以管理员权限运行，部分蓝牙操作需要权限
• 检查系统蓝牙是否启用且处于可发现状态
• 若仍失败，通过Marshal.GetLastWin32Error()获取具体错误码，精准定位问题

内容的提问来源于stack exchange，提问作者Nikolay