說(shuō)明

以下函數(shù)負(fù)責(zé)向遠(yuǎn)程 SDP 服務(wù)器發(fā)出服務(wù)搜索屬性請(qǐng)求。如果成功，此函數(shù)將返回零；如果發(fā)生錯(cuò)誤，則返回負(fù)值。

參數(shù)

此命令需要兩個(gè)參數(shù)。第一個(gè)參數(shù)是查詢索引，第二個(gè)參數(shù)是配置文件索引。

命令調(diào)用示例

• “ServiceDiscovery 1 12”嘗試根據(jù)查詢索引 1 和配置文件索引 12（免提）打開音頻網(wǎng)關(guān)客戶端端口。
• “ServiceDiscovery 3 12”嘗試根據(jù)查詢索引 3 和配置文件索引 12（免提）打開音頻網(wǎng)關(guān)客戶端端口。

可能的返回值

• (-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 調(diào)用

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 說(shuō)明

以下函數(shù)負(fù)責(zé)向指定的 BD_ADDR 發(fā)出 SDP 服務(wù)搜索屬性請(qǐng)求。此函數(shù)返回在調(diào)用此函數(shù)時(shí)指定的 SDP 響應(yīng)回調(diào)中的服務(wù)搜索屬性請(qǐng)求的結(jié)果。該函數(shù)將以下內(nèi)容作為輸入：SDP 客戶端所在的藍(lán)牙協(xié)議棧的 ID、要遠(yuǎn)程連接到的藍(lán)牙板地址（遠(yuǎn)程 SDP 服務(wù)器位于此 BD_ADDR 上）、要搜索的服務(wù) UUID 數(shù)量、要實(shí)際搜索的服務(wù) UUID、要查詢的屬性列表中的條目數(shù)、要在查詢中實(shí)際使用的屬性列表、SDP 響應(yīng)回調(diào)函數(shù)，以及 SDP 響應(yīng)回調(diào)函數(shù)回調(diào)參數(shù)。如果成功，此函數(shù)將返回一個(gè)正的非零代碼；如果出現(xiàn)錯(cuò)誤，則返回一個(gè)負(fù)的錯(cuò)誤代碼。如果該函數(shù)成功，用戶可以調(diào)用 SDP_Cancel_Service_Request() 函數(shù)以提前取消 SDP 服務(wù)搜索請(qǐng)求。UUID 數(shù)量參數(shù)必須至少為 1，并且服務(wù) UUID 參數(shù)必須指向至少包含已指定的 UUID 數(shù)量的列表。最后，BD_ADDR 參數(shù)和 SDP_Reponse_Callback 參數(shù)必須有效，否則對(duì)此函數(shù)的調(diào)用將失敗。屬性列表中的屬性數(shù)量必須至少為 1，并且屬性 ID 列表參數(shù)必須指向至少包含已指定的屬性列表?xiàng)l目數(shù)量的屬性 ID 列表。最后，BD_ADDR 參數(shù)和 SDP_Reponse_Callback 參數(shù)必須有效，否則對(duì)此函數(shù)的調(diào)用將失敗。