說明

PINCodeResponse 命令負責發出 GAP 身份驗證響應，通過輸入參數指定其 PIN 碼值。此函數在成功執行時返回零，而在出現任何錯誤時返回負值。必須存在藍牙協議棧 ID，才能嘗試調用此函數。該設備還必須正在進行由本地設備或遠程設備啟動的配對操作。

參數

PINCodeResponse 命令需要一個參數，即用于對連接進行身份驗證的 PIN 碼。這是一個字符串值，最長可達 16 位數字。配對發起方查看在配對過程中顯示的消息來調用此命令。在發起方輸入 PIN 碼后，響應方會收到一條調用此命令的消息。

命令調用示例

• “PINCodeResponse 1234”嘗試將 PIN 碼設置為“1234”。
• “PINCodeResponse 5921302312564542”嘗試將 PIN 碼設置為“5921302312564542”。該值表示最長的 16 位 PIN 碼值。

可能的返回值

• (0) 成功的 PIN 碼響應
• (-4) FUNCTION_ERROR
• (-6) INVALID_PARAMETERS_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 調用

GAP_Authentication_Response(BluetoothStackID, CurrentRemoteBD_ADDR, &GAP_Authentication_Information)

API 原型

int BTPSAPI GAP_Authentication_Response(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Authentication_Information_t *GAP_Authentication_Information)

API 說明

提供此函數是為了能夠讓本地設備響應 GAP 身份驗證事件。此函數用于為指定的藍牙設備指定身份驗證信息。該函數將以下內容作為輸入：已請求身份驗證操作的藍牙設備的藍牙協議棧 ID 以及身份驗證響應信息（由調用方指定）。