Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

BluetoothSdpGetAttributeValue function

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

pRecordStream [in]

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

cbRecordLength [in]

Length of pRecordStream, in bytes.

usAttributeId [in]

Attribute identifier to search for. See Remarks.

pAttributeData [out]

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

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

None supported

Header

BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)

Library

Bthprops.lib

DLL

Bthprops.dll

See also

BluetoothSdpEnumAttributes
BluetoothSdpGetContainerElementData
BluetoothSdpGetElementData
BluetoothSdpGetString
SDP_ELEMENT_DATA
SDP_STRING_TYPE_DATA

 

 

Community Additions

Show:
© 2014 Microsoft