Fonction BluetoothAuthenticateMultipleDevices (bluetoothapis.h)

Article
02/23/2024

La fonction BluetoothAuthenticateMultipleDevices permet à l’appelant de demander l’authentification de plusieurs appareils pendant une seule instance de l’Assistant Connexion Bluetooth.

RemarqueBluetoothAuthenticateMultipleDevices a été déprécié. L’implémentation de cette API n’est pas recommandée.

Syntaxe

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

Paramètres

hwndParent

Fenêtre qui doit être le parent de l’Assistant Authentification. Si la valeur est NULL, l’Assistant est parenté hors du bureau.

hRadio

Handle radio local valide, ou NULL. Si la valeur est NULL, l’authentification est tentée sur toutes les radios locales ; si une radio réussit, l’appel de fonction réussit.

cDevices

Nombre d’appareils dans le tableau pbtdi de structures BLUETOOTH_DEVICE_INFO .

rgbtdi

Tableau de structures BLUETOOTH_DEVICE_INFO qui contiennent des enregistrements pour les appareils Bluetooth à authentifier.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution ; case activée l’indicateur fAuthenticate pour chaque appareil.

Le tableau suivant répertorie les erreurs courantes.

Code de retour	Description
ERROR_CANCELLED	L’utilisateur a annulé l’opération. Vérifiez l’indicateur fAuthenticate pour chaque appareil Bluetooth pour déterminer si des appareils ont été authentifiés avant que l’utilisateur annule l’opération.
ERROR_INVALID_PARAMETER	Un ou plusieurs des appareils du tableau pbtdi n’étaient pas valides.
ERROR_NO_MORE_ITEMS	Tous les appareils pointés par pbtdi sont déjà marqués comme authentifiés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)
Bibliothèque	Bthprops.lib
DLL	bthprops.cpl