bluetoothSdpEnumAttributes 函数 (bluetoothapis.h)

项目
03/05/2024

BluetoothSdpEnumAttributes 函数通过 SDP 记录流枚举，并为记录中的每个属性调用回调函数。

语法

BOOL BluetoothSdpEnumAttributes(
  LPBYTE                                 pSDPStream,
  ULONG                                  cbStreamSize,
  PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK pfnCallback,
  LPVOID                                 pvParam
);

参数

pSDPStream

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

cbStreamSize

pSDPStream 指向的流的大小（以字节为单位）。

pfnCallback

指向回调例程的指针。有关回调的详细信息，请参阅 PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK 。

pvParam

要传递给回调例程的可选参数。

返回值

如果发生枚举，则返回 TRUE 。失败时返回 FALSE 。有关详细信息，请调用 GetLastError 函数。下表描述了与 BluetoothSdpEnumAttributes 函数关联的常见错误代码：

返回代码	说明
ERROR_INVALID_PARAMETER	pSDPStream 或 pfnCallback 参数为 NULL。
ERROR_INVALID_DATA	SDP 流已损坏。

注解

如果回调函数返回 FALSE，则由 BluetoothSdpEnumAttributes 函数启动的枚举将停止。

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

要求

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