Función BluetoothAuthenticateMultipleDevices (bluetoothapis.h)

Artículo
02/23/2024

La función BluetoothAuthenticateMultipleDevices permite al autor de la llamada solicitar que varios dispositivos se autentiquen durante una sola instancia del Asistente para conexión Bluetooth.

NotaBluetoothAuthenticateMultipleDevices está en desuso. No se recomienda la implementación de esta API.

Sintaxis

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

Parámetros

hwndParent

Ventana que va a ser el elemento primario del Asistente para autenticación. Si se establece en NULL, el asistente está primario fuera del escritorio.

hRadio

Identificador de radio local válido o NULL. Si es NULL, se intenta autenticar en todas las radios locales; si alguna radio se realiza correctamente, la llamada de función se realiza correctamente.

cDevices

Número de dispositivos de la matriz pbtdi de estructuras de BLUETOOTH_DEVICE_INFO .

rgbtdi

Matriz de estructuras de BLUETOOTH_DEVICE_INFO que contienen registros para los dispositivos Bluetooth que se van a autenticar.

Valor devuelto

Devuelve ERROR_SUCCESS tras completarse correctamente; compruebe la marca fAuthenticate para cada dispositivo.

En la tabla siguiente se enumeran los errores comunes.

Código devuelto	Descripción
ERROR_CANCELLED	El usuario canceló la operación. Compruebe la marca fAuthenticate para cada dispositivo Bluetooth para determinar si los dispositivos se autenticaron antes de que el usuario cancelara la operación.
ERROR_INVALID_PARAMETER	Uno o varios de los dispositivos de la matriz pbtdi no eran válidos.
ERROR_NO_MORE_ITEMS	Todos los dispositivos a los que apunta pbtdi ya están marcados como autenticados.

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 (incluya Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl