说明

以下函数负责向远程 SDP 服务器发出服务搜索属性请求。如果成功，此函数将返回零；如果发生错误，则返回负值。

参数

此命令需要两个参数。第一个参数是查询索引，第二个参数是配置文件索引。

命令调用示例

• “ServiceDiscovery 1 12”尝试根据查询索引 1 和配置文件索引 12（免提）打开音频网关客户端端口。
• “ServiceDiscovery 3 12”尝试根据查询索引 3 和配置文件索引 12（免提）打开音频网关客户端端口。

可能的返回值

• (-1) BTPS_ERROR_INVALID_PARAMETER (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
• (-4) FUNCTION_ERROR
• (-8) INVALID_STACK_ID_ERROR
• (-40) BTPS_ERROR_MEMORY_ALLOCATION_ERROR (-54) BTPS_ERROR_EXPECTED_UUID_ENTRY (-64) BTPS_ERROR_INTERNAL_ERROR (-103)
• BTPS_ERROR_FEATURE_NOT_AVAILABLE

API 调用

SDP_Service_Search_Attribute_Request(BluetoothStackID, InquiryResultList[(TempParam->Params[0].intParam - 1)], 1, &SDPUUIDEntry, 1, &AttributeID, SDP_Event_Callback,(unsigned long)0)

API 原型

BTPSAPI_DECLARATION int BTPSAPI SDP_Service_Search_Attribute_Request(unsigned int BluetoothStackID, BD_ADDR_t BD_ADDR, unsigned int NumberServiceUUID,SDP_UUID_Entry_t SDP_UUID_Entry[], unsigned int NumberAttributeListElements, SDP_Attribute_ID_List_Entry_t AttributeIDList[], SDP_Response_Callback_tSDP_Response_Callback, unsigned long CallbackParameter)

API 说明

以下函数负责向指定的 BD_ADDR 发出 SDP 服务搜索属性请求。此函数返回在调用此函数时指定的 SDP 响应回调中的服务搜索属性请求的结果。该函数将以下内容作为输入：SDP 客户端所在的蓝牙协议栈的 ID、要远程连接到的蓝牙板地址（远程 SDP 服务器位于此 BD_ADDR 上）、要搜索的服务 UUID 数量、要实际搜索的服务 UUID、要查询的属性列表中的条目数、要在查询中实际使用的属性列表、SDP 响应回调函数，以及 SDP 响应回调函数回调参数。如果成功，此函数将返回一个正的非零代码；如果出现错误，则返回一个负的错误代码。如果该函数成功，用户可以调用 SDP_Cancel_Service_Request() 函数以提前取消 SDP 服务搜索请求。UUID 数量参数必须至少为 1，并且服务 UUID 参数必须指向至少包含已指定的 UUID 数量的列表。最后，BD_ADDR 参数和 SDP_Reponse_Callback 参数必须有效，否则对此函数的调用将失败。属性列表中的属性数量必须至少为 1，并且属性 ID 列表参数必须指向至少包含已指定的属性列表条目数量的属性 ID 列表。最后，BD_ADDR 参数和 SDP_Reponse_Callback 参数必须有效，否则对此函数的调用将失败。