BluetoothSdpGetContainerElementData function

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

Syntax

DWORD BluetoothSdpGetContainerElementData(
  LPBYTE                       pContainerStream,
  ULONG                        cbContainerLength,
  HBLUETOOTH_CONTAINER_ELEMENT *pElement,
  PSDP_ELEMENT_DATA            pData
);

Parameters

pContainerStream

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

cbContainerLength

The size, in bytes, of the pContainerStream parameter.

pElement

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

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

   
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.dll

See Also

BluetoothSdpEnumAttributes

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA