说明

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 终止符）。如果成功更改了本地设备名称，此函数返回零；如果出现错误情况，则返回负的错误代码。