bluetoothSdpGetAttributeValue 函数 (bluetoothapis.h)

项目
08/22/2023

BluetoothSdpGetAttributeValue 函数检索属性标识符的属性值。

语法

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

参数

[in] pRecordStream

指向格式化为单个 SDP 记录的有效记录流的指针。

[in] cbRecordLength

pRecordStream 的长度（以字节为单位）。

[in] usAttributeId

要搜索的属性标识符。请参阅“备注”。

[out] pAttributeData

指向 SDP_ELEMENT_DATA 结构的指针，该结构将特性的标识符值放置到其中。

返回值

成功完成后返回ERROR_SUCCESS; pAddributeData 参数包含属性值。任何其他返回值都指示错误。下表描述了与 BluetoothSdpGetAttributeValue 函数关联的常见错误代码：

返回代码	说明
ERROR_INVALID_PARAMETER	其中一个必需的指针为 NULL，pRecordStream 参数不是有效的 SDP 流，或者 pRecordStream 参数不是格式正确的 SDP 记录。
ERROR_FILE_NOT_FOUND	在记录中找不到 usAttributeId 中提供的标识符。

注解

pRecordStream 中的记录流必须是格式化为 SDP 记录的 SDP 流、包含属性 ID 的 SEQUENCE (UINT16) 加上属性值 (任何 SDP 元素类型) 对。

usAttributeId 参数中提供的属性标识符可以是 bthdef.h 文件中提供的众多SDP_ATTRIB_Xxx通用属性标识符之一，也可以是蓝牙配置文件定义的自定义属性值。所有大于或等于 0x200 的值都是特定于配置文件的属性标识符，并且特定于配置文件。有关通用 SDP 属性标识符的列表，请参阅 bthdef.h 头文件。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
Library	Bthprops.lib
DLL	bthprops.cpl