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

Статья
08/22/2023

Функция BluetoothEnumerateInstalledServices перечисляет guid служб (глобальные уникальные идентификаторы), включенные на устройстве Bluetooth.

Синтаксис

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

Параметры

hRadio

Дескриптор локального радиоустройства Bluetooth. Если значение РАВНО NULL, все локальные радиослужбы выполняют поиск включенных служб, соответствующих радиоадресу в pbtdi.

pbtdi

Указатель на структуру BLUETOOTH_DEVICE_INFO .

pcServiceInout

На входных данных — количество записей, на которые указывает параметр pGuidServices . В выходных данных — количество допустимых записей, возвращаемых в параметре pGuidServices . Если pGuidServices имеет значение NULL, на выходе pcServices содержит количество включенных служб.

pGuidServices

Указатель на буфер в памяти для получения идентификаторов GUID для установленных служб. Буфер должен быть не менее *pcServices *sizeof(GUID) байт.

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

Возвращает ERROR_SUCCESS после успешного завершения, а параметр pGuidServices содержит полный список включенных GUID службы.

В следующей таблице описана распространенная ошибка:

Код возврата	Описание
ERROR_MORE_DATA	Вызов выполнен успешно. Параметр pGuidServices содержит неполный список включенных guid служб.

Требования

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