說明

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

參數(shù)

此命令需要一個(gè)參數(shù)。指定的設(shè)備名稱必須是唯一的參數(shù)（這意味著名稱中不應(yīng)有空格，否則只會(huì)設(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è)置第一個(gè)參數(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ù)是為了允許更改本地藍(lán)牙設(shè)備的設(shè)備名稱。名稱參數(shù)必須是指向以 NULL 為終止符的 ASCII 字符串的指針，且長(zhǎng)度最大為 MAX_NAME_LENGTH（不包括尾部的 NULL 終止符）。如果成功更改本地設(shè)備名稱，此函數(shù)將返回零；如果出現(xiàn)錯(cuò)誤情況，則返回負(fù)的錯(cuò)誤代碼。