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

Статья
08/22/2023

Функция BluetoothSendAuthenticationResponse вызывается при получении запроса проверки подлинности для отправки ответа ключа доступа.

Примечание При разработке для Windows Vista с пакетом обновления 2 (SP2) и Windows 7 рекомендуется использовать BluetoothSendAuthenticationResponseEx .

Синтаксис

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

Параметры

hRadio

Необязательный дескриптор для локального дескриптора радиосвязи или ЗНАЧЕНИЕ NULL. Если значение РАВНО NULL, функция пытается отправить ответ проверки подлинности на всех локальных радиосвязях.

pbtdi

Указатель на структуру BLUETOOTH_DEVICE_INFO , описывающую проверку подлинности устройства Bluetooth. Это может быть та же структура, которая передается в функцию обратного вызова.

pszPasskey

Указатель на строку, завершающуюся с нуля в ЮНИКОДе, ответа ключа доступа для отправки обратно на устройство проверки подлинности. Параметр pszPasskey не может быть больше BLUETOOTH_MAX_PASSKEY_SIZE, за исключением значения NULL. Если выполняется преобразование в ANSI, параметр pszPasskey не может быть больше 16 байт, за исключением NULL.

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

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

Код возврата	Описание
ERROR_CANCELLED	Устройство Bluetooth отклонило ответ ключа доступа. Эта ошибка также возвращается, если возникла проблема с локальным радиосвязью.
E_FAIL	Устройство вернуло код сбоя во время проверки подлинности.

Требования

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