說明
SetPasskey 命令負(fù)責(zé)查詢 LE 連接的加密模式。此命令在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負(fù)值。
注： SetPasskey 命令僅在配對時有效。
參數(shù)
SetPasskey 命令需要一個參數(shù)，即用于對連接進(jìn)行身份驗證的通行密鑰。這是一個字符串值，最長可達(dá) 6 位數(shù)字（值介于 0 和 999999 之間）。
命令調(diào)用示例
- “SetPasskey 0”嘗試刪除通行密鑰。
- “SetPasskey 1 987654”嘗試將通行密鑰設(shè)置為 987654。
- “SetPasskey 1”嘗試將通行密鑰設(shè)置為默認(rèn)的固定通行密鑰值。
可能的返回值
- (0) 成功的通行密鑰響應(yīng)
- (-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 調(diào)用
根據(jù)第一個參數(shù)選擇其中一個：
- 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 說明
提供此函數(shù)是為了能夠在配對操作期間，每當(dāng)選擇本地藍(lán)牙設(shè)備顯示通行密鑰時，可以使用固定密鑰。僅當(dāng)根據(jù)遠(yuǎn)程 I/O 功能和本地 I/O 功能選擇本地藍(lán)牙設(shè)備來顯示通行密鑰時，才會使用此固定密鑰。