Partager via

Fonction BluetoothSelectDevices (bluetoothapis.h)

  • Article

La fonction BluetoothSelectDevices permet la sélection d’appareils Bluetooth.

Syntaxe

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Paramètres

pbtsdp

Pointeur vers une structure de BLUETOOTH_SELECT_DEVICE_PARAMS qui identifie les appareils Bluetooth.

Valeur retournée

Retourne TRUE si un utilisateur a sélectionné un appareil.

Retourne FALSE si aucune donnée valide n’a été retournée. Appelez la fonction GetLastError pour récupérer les informations d’erreur. Les conditions suivantes s’appliquent aux informations d’erreur retournées.

Code de retour Description
ERROR_CANCELLED
 L’utilisateur a annulé la demande.
ERROR_INVALID_PARAMETER
 Le paramètre pbtsdp est NULL.
ERROR_REVISION_MISMATCH
 La structure passée dans pbtsdp est de taille inconnue.

Remarques

La fonction BluetoothSelectDevices ouvre une boîte de dialogue commune permettant de sélectionner des appareils Bluetooth. La liste des appareils affichés à l’utilisateur est déterminée par les indicateurs et les paramètres spécifiés par l’appelant dans le paramètre pbtsdp .

Si BluetoothSelectDevices retourne TRUE, le membre pDevices de la structure BLUETOOTH_SELECT_DEVICE_PARAMS pointe vers des données valides. L’appelant doit vérifier que les indicateurs fAuthenticated et fRemembered dans la structure BLUETOOTH_SELECT_DEVICE_PARAMS pour déterminer quels appareils ont été correctement authentifiés et quels appareils sont des sélections valides pour l’utilisateur. Appelez la fonction BluetoothSelectDevicesFree pour libérer des ressources uniquement si la fonction BluetoothSelectDevices retourne TRUE.

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

Voir aussi

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK