bluetoothEnableDiscovery 函数 (bluetoothapis.h)

项目
02/23/2024

BluetoothEnableDiscovery 函数更改本地蓝牙无线电或无线电的发现状态。

语法

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

参数

hRadio

有效的本地单选句柄或 NULL。如果 为 NULL，则在所有本地无线电上修改发现;如果调用修改了任何无线电，则函数调用成功。

fEnabled

指定是启用还是禁用发现的标志。设置为 TRUE 可启用发现，设置为 FALSE 可禁用发现。

返回值

如果发现状态已成功更改，则返回 TRUE 。如果 hRadio 为 NULL，则返回值 TRUE 表示至少一个本地无线电状态已成功更改。如果未更改发现状态，则返回 FALSE ;如果 hRadio 为 NULL，则没有无线电接受状态更改。

注解

使用 BluetoothIsDiscoverable 函数确定蓝牙无线电的当前状态。 Windows 确保可发现的系统可连接，因此，无线电在使无线电可发现之前必须允许传入连接。未能允许传入连接会导致 BluetoothEnableDiscovery 函数调用失败。

当 BluetoothEnableDiscovery 更改发现状态时，新状态在调用应用程序的生存期内有效。此外，如果以前通过此功能使蓝牙无线电可发现通过应用程序禁用并重新启用，则可发现性将不会保留。调用应用程序终止后，指定蓝牙无线电的发现状态将恢复到调用 BluetoothEnableDiscovery 之前的状态。

要求

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