Funzione BluetoothAuthenticateMultipleDevices (bluetoothapis.h)

Articolo
03/14/2023

La funzione BluetoothAuthenticateMultipleDevices consente al chiamante di richiedere l'autenticazione di più dispositivi durante una singola istanza della procedura guidata Connessione Bluetooth.

NotaBluetoothAuthenticateMultipleDevices è stato deprecato. L'implementazione di questa API non è consigliata.

Sintassi

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

Parametri

hwndParent

Finestra da inserire nell'elemento padre della procedura guidata Autenticazione. Se impostato su NULL, la procedura guidata viene padreata dal desktop.

hRadio

Handle di radio locale valido o NULL. Se NULL, l'autenticazione viene tentata su tutte le radio locali; se una radio ha esito positivo, la chiamata alla funzione ha esito positivo.

cDevices

Numero di dispositivi nella matrice pbtdi di strutture BLUETOOTH_DEVICE_INFO .

rgbtdi

Matrice di strutture BLUETOOTH_DEVICE_INFO che contengono record per i dispositivi Bluetooth da autenticare.

Valore restituito

Restituisce ERROR_SUCCESS al completamento positivo; controllare il flag fAuthenticate per ogni dispositivo.

La tabella seguente elenca gli errori comuni.

Codice restituito	Descrizione
ERROR_CANCELLED	L'utente ha annullato l'operazione. Controllare il flag fAuthenticate per ogni dispositivo Bluetooth per determinare se tutti i dispositivi sono stati autenticati prima che l'utente annullasse l'operazione.
ERROR_INVALID_PARAMETER	Uno o più dispositivi nella matrice pbtdi non sono validi.
ERROR_NO_MORE_ITEMS	Tutti i dispositivi a cui fa riferimento pbtdi sono già contrassegnati come autenticati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (includere Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl