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

Статья
02/23/2024

Функция BluetoothAuthenticateMultipleDevices позволяет вызывающей стороны запрашивать проверку подлинности нескольких устройств во время одного экземпляра мастера подключения Bluetooth.

Примечание. BluetoothAuthenticateMultipleDevices является устаревшим. Реализация этого API не рекомендуется.

Синтаксис

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

Параметры

hwndParent

Окно, в качестве родительского для мастера проверки подлинности. Если задано значение NULL, мастер будет оточен от рабочего стола.

hRadio

Допустимый локальный дескриптор радиосвязи или NULL. Если значение РАВНО NULL, попытка проверки подлинности выполняется на всех локальных радиосвязях; Если какой-либо радиосвязи успешно работает, вызов функции завершается успешно.

cDevices

Количество устройств в массиве pbtdiBLUETOOTH_DEVICE_INFO структур.

rgbtdi

Массив структур BLUETOOTH_DEVICE_INFO , содержащих записи для проверки подлинности устройств Bluetooth.

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

Возвращает ERROR_SUCCESS после успешного завершения; проверка флаг fAuthenticate для каждого устройства.

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

Код возврата	Описание
ERROR_CANCELLED	Пользователь отменил операцию. Проверьте флаг fAuthenticate для каждого устройства Bluetooth, чтобы определить, прошли ли какие-либо устройства проверку подлинности до того, как пользователь отменил операцию.
ERROR_INVALID_PARAMETER	Одно или несколько устройств в массиве pbtdi были недопустимыми.
ERROR_NO_MORE_ITEMS	Все устройства, на которые указывает pbtdi , уже помечены как прошедшие проверку подлинности.

Требования

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