說明

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 指定的藍牙協議棧所指定的本地藍牙設備的可連接性模式。第二個參數指定要將本地藍牙設備置于的可連接性模式。