说明
SetLocalName 命令负责将本地蓝牙设备的名称设置为指定名称。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。
参数
此命令需要一个参数。指定的设备名称必须是唯一的参数。
注： 请勿在名称中添加空格，否则只会设置名称的第一部分。
命令调用示例
- “SetLocalName New_Bluetooth_Device_Name”尝试将本地设备名称设置为“New_Bluetooth_Device_Name”。
- “SetLocalName New Bluetooth Device Name”尝试将本地设备名称设置为“New Bluetooth Device Name”，但仅设置第一个参数，这将使本地设备名称变为“New”。
- “SetLocalName MSP430”尝试将本地设备名称设置为“MSP430”。
可能的返回值
- (0) 成功设置本地设备名称
- (-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 调用
GAP_Set_Local_Device_Name(BluetoothStackID, TempParam->Params[0].strParam)
API 原型
int BTPSAPI GAP_Set_Local_Device_Name(unsigned int BluetoothStackID, char *Name)
API 说明
提供此函数是为了允许更改本地蓝牙设备的设备名称。名称参数必须是指向以 NULL 为终止符的 ASCII 字符串的指针，且长度最大为 MAX_NAME_LENGTH（不包括尾部的 NULL 终止符）。如果成功更改了本地设备名称，此函数返回零；如果出现错误情况，则返回负的错误代码。