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

Статья
08/22/2023

Функция BluetoothRegisterForAuthentication регистрирует функцию обратного вызова, которая вызывается, когда определенное устройство Bluetooth запрашивает проверку подлинности.

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

Синтаксис

DWORD BluetoothRegisterForAuthentication(
  const BLUETOOTH_DEVICE_INFO            *pbtdi,
  HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandle,
  PFN_AUTHENTICATION_CALLBACK            pfnCallback,
  PVOID                                  pvParam
);

Параметры

pbtdi

Указатель на структуру BLUETOOTH_DEVICE_INFO . Для сравнения используется элемент Address.

phRegHandle

Указатель на структуру, в которой хранится дескриптор регистрации. Вызовите BluetoothUnregisterAuthentication , чтобы закрыть дескриптор.

pfnCallback

Функция, вызываемая при возникновении события проверки подлинности. Функция должна соответствовать прототипу, описанному в PFN_AUTHENTICATION_CALLBACK.

pvParam

Необязательный параметр, передаваемый через функцию обратного вызова.

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

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

Вызовите функцию GetLastError , чтобы получить дополнительные сведения об ошибке. В следующей таблице описана распространенная ошибка:

Код возврата	Описание
ERROR_OUTOFMEMORY	Недостаточно памяти.

Требования

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