BluetoothSdpGetAttributeValue function (bluetoothapis.h)

Article
02/22/2024

The BluetoothSdpGetAttributeValue function retrieves the attribute value for an attribute identifier.

Syntax

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

Parameters

[in] pRecordStream

Pointer to a valid record stream that is formatted as a single SDP record.

[in] cbRecordLength

Length of pRecordStream, in bytes.

[in] usAttributeId

Attribute identifier to search for. See Remarks.

[out] pAttributeData

Pointer to an SDP_ELEMENT_DATA structure into which the attribute's identifier value is placed.

Return value

Returns ERROR_SUCCESS upon successful completion; the pAddributeData parameter contains the attribute value. Any other return value indicates error. The following table describes common error codes associated with the BluetoothSdpGetAttributeValue function:

Return code	Description
ERROR_INVALID_PARAMETER	Either one of the required pointers was NULL, the pRecordStream parameter was not a valid SDP stream, or the pRecordStream parameter was not a properly formatted SDP record.
ERROR_FILE_NOT_FOUND	The identifier provided in usAttributeId was not found in the record.

Remarks

The record stream in pRecordStream must be an SDP stream formatted as an SDP record, a SEQUENCE containing attribute ID (UINT16) plus attribute value (any SDP element type) pairs.

The attribute identifier provided in the usAttributeId parameter can be one of the many SDP_ATTRIB_Xxx universal attribute identifiers provided in the bthdef.h file, or a custom attribute value defined by a Bluetooth profile. All values greater than or equal to 0x200 are profile-specific attribute identifiers, and are specific to the profile. See the bthdef.h header file for a list of universal SDP attribute identifiers.

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