BluetoothSdpGetContainerElementData function (bluetoothapis.h)

The BluetoothSdpGetContainerElementData function iterates a container stream and returns each element contained within the container element.

Syntax

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

Parameters

[in] pContainerStream

A pointer to valid SDP stream. The first element in the stream must be a sequence or an alternative.

[in] cbContainerLength

The size, in bytes, of the pContainerStream parameter.

[in, out] pElement

A value used to track the location in the stream. The first time the BluetoothSdpGetContainerElementData function is called for a container, *pElement should be NULL. For subsequent calls, the value should be unmodified.

[out] pData

A pointer to a buffer filled with data from the current SDP element of pContainerStream.

Return value

Returns ERROR_SUCCESS upon success, indicating that the pData parameter contains the data. Returns error codes upon failure. The following table describes common error codes associated with the BluetoothSdpGetContainerElementData function:

Return code Description
ERROR_NO_MORE_ITEMS
There are no more items in the list. The caller should stop calling the BluetoothSdpGetContainerElementData function for this container.
ERROR_INVALID_PARAMETER
A required pointer is NULL, or the container is not a valid SDP stream.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Library Bthprops.lib
DLL bthprops.cpl

See also

BluetoothSdpEnumAttributes

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA