说明

GetRemoteName 命令负责查询远程设备的蓝牙设备名称。此函数在成功执行时返回零，而在出现任何错误时返回负值。此命令要求在运行之前存在有效的蓝牙协议栈 ID，并在使用 Inquiry 命令后调用。在这种情况下，DisplayInquiryList 命令可用于查找哪个远程设备与哪个查询索引关联。

参数

GetRemoteName 命令需要一个参数，即远程蓝牙设备的查询索引。该值可以在查询后找到，或者在使用命令 DisplayInquiryList 时显示。

命令调用示例

• “GetRemoteName 5”尝试查询位于第五个查询索引处的远程设备的设备名称。
• “GetRemoteName 8”尝试查询位于第八个查询索引处的远程设备的设备名称。

可能的返回值

• (0) 成功查询远程名称
• (-6) INVALID_PARAMETERS_ERROR
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-1) BTPS_ERROR_INVALID_PARAMETER
• (-59) BTPS_ERROR_ADDING_CALLBACK_INFORMATION
• (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 调用

GAP_Query_Remote_Device_Name(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam – 1)], GAP_Event_Callback, (unsigned long)0);

API 原型

int BTPSAPI GAP_Query_Remote_Device_Name(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, GAP_Event_Callback_t GAP_Event_Callback, unsigned longCallbackParameter);

API 说明

提供此函数是为了能够查询指定远程蓝牙设备的用户友好的蓝牙设备名称。该函数将以下内容作为输入：远程蓝牙设备的地址（用于查询该设备的名称）以及 GAP 事件回调信息（在远程设备名称查询过程完成时需要使用）。如果成功，此函数返回零；如果无法提交远程名称请求，则返回负的错误代码。如果此函数返回成功结果，则在确定远程名称信息后（或存在错误时），将通过指定的回调通知调用方。此函数无法用于确定本地蓝牙设备的用户友好名称。GAP_Query_Local_Name 函数用于查询本地蓝牙设备的用户友好名称。由于此函数本质上是异步的（指定远程设备地址），因此该函数通过指定的回调向调用方通知结果。通过发出 GAP_Cancel_Query_Remote_Name 函数并指定蓝牙设备的蓝牙设备地址（在对该函数的原始调用中指定），调用方可以随时取消远程名称请求。请注意，如果取消回调并且操作尝试取消，则会取消回调（即，GAP 模块仍执行远程名称请求，但始终不发出回调）。