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

Статья
02/23/2024

Функция BluetoothSdpGetString преобразует необработанную строку, внедренную в запись SDP, в строку Юникода.

Синтаксис

DWORD BluetoothSdpGetString(
  [in]      LPBYTE                      pRecordStream,
  [in]      ULONG                       cbRecordLength,
  [in]      const PSDP_STRING_TYPE_DATA pStringData,
  [in]      USHORT                      usStringOffset,
  [out]     PWSTR                       pszString,
  [in, out] PULONG                      pcchStringLength
);

Параметры

[in] pRecordStream

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

[in] cbRecordLength

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

[in] pStringData

Если задано значение NULL, языковой стандарт вызывающего потока используется для поиска соответствующей строки в записи SDP. Если значение не равно NULL, то для поиска строки для преобразования используются элементы mibeNum и attributeId структуры SDP_STRING_TYPE_DATA .

[in] usStringOffset

Смещение типа строки SDP для преобразования. UsStringOffset добавляется к базовому идентификатору атрибута строки. Смещения, определяемые спецификацией SDP: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET и STRING_PROVIDER_NAME_OFFSET. Эти смещения можно найти в файле заголовка bthdef.h.

[out] pszString

Если значение не равно NULL, содержит преобразованную строку в выходных данных. Если задано значение NULL, параметр pcchStringLength заполняется необходимым количеством символов, а не байтами для получения преобразованной строки.

[in, out] pcchStringLength

Во входных данных содержит длину pszString , если pszString не имеет значение NULL, в символах.

В выходных данных содержит количество обязательных символов, включая NULL , если возвращается ошибка, или число символов, записанных в pszString, включая NULL.

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

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

Код возврата	Описание
ERROR_MORE_DATA	Параметр pszString имеет значение NULL или слишком мал, чтобы содержать преобразованную строку; Параметр pcchStringLength содержит необходимую длину в символах.
ERROR_INVALID_DATA	Преобразование не может быть выполнено.
ERROR_NO_SYSTEM_RESOURCES	Система не может внутренне выделить память для выполнения преобразования.
ERROR_INVALID_PARAMETER	Один из обязательных указателей — NULL, параметр pRecordStream не является допустимым потоком SDP, pRecordStream — неправильно отформатированная запись или запрошенный атрибут с смещением не является строкой.

Требования

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