Функция BluetoothSdpGetAttributeValue (bluetoothapis.h)

Статья
08/22/2023

Функция BluetoothSdpGetAttributeValue извлекает значение атрибута для идентификатора атрибута.

Синтаксис

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

Параметры

[in] pRecordStream

Указатель на допустимый поток записей, отформатированный как одна запись SDP.

[in] cbRecordLength

Длина pRecordStream в байтах.

[in] usAttributeId

Идентификатор атрибута для поиска. См. заметки.

[out] pAttributeData

Указатель на структуру SDP_ELEMENT_DATA , в которую помещается значение идентификатора атрибута.

Возвращаемое значение

Возвращает ERROR_SUCCESS после успешного завершения; Параметр pAddributeData содержит значение атрибута. Любое другое возвращаемое значение указывает на ошибку. В следующей таблице описаны распространенные коды ошибок, связанные с функцией BluetoothSdpGetAttributeValue :

Код возврата	Описание
ERROR_INVALID_PARAMETER	Один из обязательных указателей имеет значение NULL, параметр pRecordStream не является допустимым потоком SDP или параметр pRecordStream не является правильно отформатированным SDP-записью.
ERROR_FILE_NOT_FOUND	Идентификатор, указанный в usAttributeId , не найден в записи.

Поток записей в pRecordStream должен быть потоком SDP, отформатированным в виде записи SDP, последовательности, содержащей пары идентификатора атрибута (UINT16) плюс значение атрибута (любой тип элемента SDP).

Идентификатор атрибута, указанный в параметре usAttributeId , может быть одним из многих SDP_ATTRIB_Xxx универсальных идентификаторов атрибутов, предоставленных в файле bthdef.h, или пользовательским значением атрибута, определенным профилем Bluetooth. Все значения, превышающие или равные 0x200, являются идентификаторами атрибутов профиля и зависят от профиля. Список универсальных идентификаторов атрибутов SDP см. в файле заголовка bthdef.h.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h)
Библиотека	Bthprops.lib
DLL	bthprops.cpl