ZHCACZ4 August 2023 CC2564C
SetLocalName 命令负责将本地蓝牙设备的名称设置为指定名称。此函数在成功执行时返回零,而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID,才能尝试调用此函数。
此命令需要一个参数。指定的设备名称必须是唯一的参数(这意味着名称中不应有空格,否则只会设置该名称的第一部分)。
GAP_Set_Local_Device_Name(BluetoothStackID, TempParam->Params[0].strParam);
int BTPSAPI GAP_Set_Local_Device_Name(unsigned int BluetoothStackID, char *Name);
提供此函数是为了允许更改本地蓝牙设备的设备名称。名称参数必须是指向以 NULL 为终止符的 ASCII 字符串的指针,且长度最大为 MAX_NAME_LENGTH(不包括尾部的 NULL 终止符)。如果成功更改本地设备名称,此函数将返回零;如果出现错误情况,则返回负的错误代码。