通过

BluetoothFindFirstRadio 函数 (bluetoothapis.h)

  • 项目

BluetoothFindFirstRadio 函数开始枚举本地蓝牙无线电。

语法

HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
        const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
  [out] HANDLE                            *phRadio
);

参数

pbtfrp

指向 BLUETOOTH_FIND_RADIO_PARAMS 结构的指针。 pbtfrp 指向的 BLUETOOTH_FIND_RADIO_PARAMS 结构的 dwSize 成员必须与结构的大小匹配。

[out] phRadio

指向将返回第一个枚举单选句柄的指针。 不再需要时，必须通过 CloseHandle 关闭此句柄。

返回值

除了 phRadio 指示的句柄外，调用此函数还将创建HBLUETOOTH_RADIO_FIND句柄，以便与 BluetoothFindNextRadio 函数一起使用。 当不再需要此句柄时，必须通过 BluetoothFindRadioClose 将其关闭。

失败时返回 NULL 。 有关错误的详细信息，请调用 GetLastError 函数。 下表描述了常见错误：

返回代码 说明
ERROR_NO_MORE_ITEMS
 找不到蓝牙无线电。
ERROR_INVALID_PARAMETER
 pbtfrp 参数为 NULL。
ERROR_REVISION_MISMATCH
 pbtfrp 指向的结构大小不正确。
ERROR_OUTOFMEMORY
 内存不足。

要求

要求 值
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
Library Bthprops.lib
DLL bthprops.cpl

另请参阅

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError