说明

此函数负责查询本地蓝牙设备的名称。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。

参数

使用此命令时不需要包含参数。参数对查询的结果没有影响。

可能的返回值

• (0) 成功查询本地设备名称
• (-8) INVALID_STACK_ID_ERROR
• (-4) FUNCTION_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR
• (-65) BTPS_ERROR_INSUFFICIENT_BUFFER_SPACE

API 调用

GAP_Query_Local_Device_Name(BluetoothStackID, 257, (char *)LocalName);

API 原型

int BTPSAPI GAP_Query_Local_Device_Name(unsigned int BluetoothStackID, unsigned int NameBufferLength, char *NameBuffer);

API 说明

此函数负责查询（和报告）本地蓝牙设备的用户友好名称。此函数的最后几个参数指定要接收本地设备名称的缓冲区和缓冲区长度。NameBufferLength 参数至少应为 (MAX_NAME_LENGTH+1)，以保存允许的最长设备名称（加上用于保留 NULL 终止符的单个字符）。如果成功，则此函数将返回零，并且 NameBuffer 指向的缓冲区将填充本地设备名称的 ASCII 表示形式（以 NULL 为终止符）。如果此函数返回负值，则无法查询本地设备名称（错误情况）。