Función BluetoothSendAuthenticationResponse (bluetoothapis.h)

Artículo
02/26/2024

Se llama a la función BluetoothSendAuthenticationResponse cuando se recibe una solicitud de autenticación para enviar la respuesta de la clave de acceso.

Nota Al desarrollar para Windows Vista SP2 y Windows 7, se recomienda el uso de BluetoothSendAuthenticationResponseEx .

Sintaxis

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

Parámetros

hRadio

Identificador opcional para el identificador de radio local o NULL. Si es NULL, la función intenta enviar una respuesta de autenticación en todas las radios locales.

pbtdi

Puntero a una estructura de BLUETOOTH_DEVICE_INFO que describe el dispositivo Bluetooth que se está autenticando. Puede ser la misma estructura que se pasa a la función de devolución de llamada.

pszPasskey

Puntero a una cadena terminada en cero UNICODE de la respuesta de clave de paso que se enviará al dispositivo de autenticación. El parámetro pszPasskey no puede ser mayor que BLUETOOTH_MAX_PASSKEY_SIZE, excepto NULL. Si se realiza la traducción a ANSI, el parámetro pszPasskey no puede ser superior a 16 bytes, excepto NULL.

Valor devuelto

Devuelve ERROR_SUCCESS cuando el dispositivo acepta la respuesta passkey; el dispositivo se autentica. Cualquier otro valor devuelto indica un error. En la tabla siguiente se describen los errores comunes:

Código devuelto	Descripción
ERROR_CANCELLED	El dispositivo Bluetooth denegó la respuesta de la clave de acceso. Este error también se devuelve si existe un problema de comunicación con la radio local.
E_FAIL	El dispositivo devolvió un código de error durante la autenticación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	bluetoothapis.h (incluye Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl