BluetoothSdpGetContainerElementData 函数 (bluetoothapis.h)

BluetoothSdpGetContainerElementData 函数循环访问容器流并返回容器元素中包含的每个元素。

语法

DWORD BluetoothSdpGetContainerElementData(
  [in]      LPBYTE                       pContainerStream,
  [in]      ULONG                        cbContainerLength,
  [in, out] HBLUETOOTH_CONTAINER_ELEMENT *pElement,
  [out]     PSDP_ELEMENT_DATA            pData
);

参数

[in] pContainerStream

指向有效 SDP 流的指针。 流中的第一个元素必须是序列或替代元素。

[in] cbContainerLength

pContainerStream 参数的大小（以字节为单位）。

[in, out] pElement

用于跟踪流中的位置的值。 首次为容器调用 BluetoothSdpGetContainerElementData 函数时，*pElement 应为 NULL。 对于后续调用，该值应未修改。

[out] pData

指向用 pContainerStream 的当前 SDP 元素中的数据填充的缓冲区的指针。

返回值

成功后返回 ERROR_SUCCESS ，指示 pData 参数包含数据。 失败时返回错误代码。 下表描述了与 BluetoothSdpGetContainerElementData 函数关联的常见错误代码：

返回代码	说明
ERROR_NO_MORE_ITEMS	列表中没有任何项。 调用方应停止为此容器调用 BluetoothSdpGetContainerElementData 函数。
ERROR_INVALID_PARAMETER	所需的指针为 NULL，或者容器不是有效的 SDP 流。

要求

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

另请参阅

BluetoothSdpEnumAttributes

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA