Fonction BluetoothSelectDevices (bluetoothapis.h)
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 |
|---|---|
|
L’utilisateur a annulé la demande. |
|
Le paramètre pbtsdp est NULL. |
|
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 |