说明

SetConnectabilityMode 命令负责设置本地设备的可连接性模式。此命令在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。

参数

此命令只需要一个表示可发现性模式的整数值参数。该值必须指定为 0（表示非连接）或 1（表示可连接）。

命令调用示例

• “SetConnectabilityMode 0”尝试将本地设备的可连接性模式设置为非连接。
• “SetConnectabilityMode 1”尝试将本地设备的可连接性模式设置为可连接。

可能的返回值

• (0) 成功设置可连接性模式
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-5) BTPS_ERROR_GAP_NOT_INITIALIZED
• (-58) BTPS_ERROR_INVALID_MODE
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 调用

GAP_Set_Connectability_Mode(BluetoothStackID, ConnectableMode);

API 原型

int BTPSAPI GAP_Set_Connectability_Mode(unsigned int BluetoothStackID, GAP_Connectability_Mode_t GAP_Connectability_Mode);

API 说明

提供此函数是为了设置由蓝牙协议栈 ID 指定的蓝牙协议栈所指定的本地蓝牙设备的可连接性模式。第二个参数指定要将本地蓝牙设备置于的可连接性模式。