说明
SetPasskey 命令负责查询 LE 连接的加密模式。此命令在成功执行时返回零，而在出现任何错误时返回负值。
注： SetPasskey 命令仅在配对时有效。
参数
SetPasskey 命令需要一个参数，即用于对连接进行身份验证的通行密钥。这是一个字符串值，最长可达 6 位数字（值介于 0 和 999999 之间）。
命令调用示例
- “SetPasskey 0”尝试删除通行密钥。
- “SetPasskey 1 987654”尝试将通行密钥设置为 987654。
- “SetPasskey 1”尝试将通行密钥设置为默认的固定通行密钥值。
可能的返回值
- (0) 成功的通行密钥响应
- (-4) FUNCTION_ERROR
- (-6) INVALID_PARAMETERS_ERROR
- (-8) INVALID_STACK_ID_ERROR
- (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
- (-1) BTPS_ERROR_INVALID_PARAMETER
- (-56) BTPS_ERROR_GAP_NOT_INITIALIZED
- (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE
API 调用
根据第一个参数选择其中一个：
- GAP_LE_Set_Fixed_Passkey(BluetoothStackID, &Passkey)
- GAP_LE_Set_Fixed_Passkey(BluetoothStackID, NULL)
API 原型
int BTPSAPI GAP_LE_Set_Fixed_Passkey(unsigned int BluetoothStackID, DWord_t *Fixed_Display_Passkey)
API 说明
提供此函数是为了能够在配对操作期间，每当选择本地蓝牙设备显示通行密钥时，可以使用固定密钥。仅当根据远程 I/O 功能和本地 I/O 功能选择本地蓝牙设备来显示通行密钥时，才会使用此固定密钥。