說明

SetLocalName 命令負責(zé)將本地藍牙設(shè)備的名稱設(shè)置為指定名稱。此命令在成功執(zhí)行時返回零，而在出現(xiàn)任何錯誤時返回負值。必須存在藍牙協(xié)議棧 ID，才能嘗試調(diào)用此命令。

參數(shù)

此命令需要一個參數(shù)。指定的設(shè)備名稱必須是唯一的參數(shù)（這意味著名稱中不應(yīng)有空格。如果名稱中包含空格，則僅設(shè)置名稱的第一部分。）

命令調(diào)用示例

• “SetLocalName New_Bluetooth_Device_Name”嘗試將本地設(shè)備名稱設(shè)置為“New_Bluetooth_Device_Name”。
• “SetLocalName New Bluetooth Device Name”嘗試將本地設(shè)備名稱設(shè)置為“New Bluetooth Device Name”，但僅設(shè)置第一個參數(shù)，這將使本地設(shè)備名稱變?yōu)椤癗ew”。
• “SetLocalName MSP430”嘗試將本地設(shè)備名稱設(shè)置為“MSP430”。

可能的返回值

• (0) 成功設(shè)置本地設(shè)備名稱
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-8) INVALID_STACK_ID_ERROR
• (-4) FUNCTION_ERROR
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 調(diào)用

GAP_Set_Local_Device_Name(BluetoothStackID, TempParam->Params[0].strParam)

API 原型

int BTPSAPI GAP_Set_Local_Device_Name(unsigned int BluetoothStackID, char *Name)

API 說明

提供此函數(shù)是為了允許更改本地藍牙設(shè)備的設(shè)備名稱。名稱參數(shù)必須是指向以 NULL 為終止符的 ASCII 字符串的指針，且長度最大為 MAX_NAME_LENGTH（不包括尾部的 NULL 終止符）。如果成功更改了本地設(shè)備名稱，此函數(shù)返回零；如果出現(xiàn)錯誤情況，則返回負的錯誤代碼。