BluetoothSdpGetAttributeValue function

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

Syntax

DWORD BluetoothSdpGetAttributeValue(
  LPBYTE            pRecordStream,
  ULONG             cbRecordLength,
  USHORT            usAttributeId,
  PSDP_ELEMENT_DATA pAttributeData
);

Parameters

pRecordStream

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

cbRecordLength

Length of pRecordStream, in bytes.

usAttributeId

Attribute identifier to search for. See Remarks.

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 pRecordStreammust 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

   
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

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA