Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 |
|---|---|
|
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. |
|
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 |