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

Статья
02/26/2024

Функция BluetoothSdpGetContainerElementData выполняет итерацию потока контейнера и возвращает каждый элемент, содержащийся в элементе контейнера.

Синтаксис

DWORD BluetoothSdpGetContainerElementData(
  [in]      LPBYTE                       pContainerStream,
  [in]      ULONG                        cbContainerLength,
  [in, out] HBLUETOOTH_CONTAINER_ELEMENT *pElement,
  [out]     PSDP_ELEMENT_DATA            pData
);

Параметры

[in] pContainerStream

Указатель на допустимый поток SDP. Первый элемент в потоке должен быть последовательностью или альтернативой.

[in] cbContainerLength

Размер параметра pContainerStream в байтах.

[in, out] pElement

Значение , используемое для отслеживания расположения в потоке. При первом вызове функции BluetoothSdpGetContainerElementData для контейнера значение *pElement должно иметь значение NULL. Для последующих вызовов значение должно быть не изменено.

[out] pData

Указатель на буфер, заполненный данными из текущего элемента SDP pContainerStream.

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

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

Код возврата	Описание
ERROR_NO_MORE_ITEMS	В списке больше нет элементов. Вызывающий объект должен прекратить вызов функции BluetoothSdpGetContainerElementData для этого контейнера.
ERROR_INVALID_PARAMETER	Обязательный указатель имеет значение NULL или контейнер не является допустимым потоком SDP.

Требования

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

См. также раздел

BluetoothSdpEnumAttributes

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA

Поделиться через