Fonction BluetoothFindFirstRadio (bluetoothapis.h)
La fonction BluetoothFindFirstRadio commence l’énumération des radios Bluetooth locales.
Syntaxe
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
[out] HANDLE *phRadio
);
Paramètres
pbtfrp
Pointeur vers une structure BLUETOOTH_FIND_RADIO_PARAMS . Le membre dwSize de la structure BLUETOOTH_FIND_RADIO_PARAMS pointée par pbtfrp doit correspondre à la taille de la structure.
[out] phRadio
Pointeur vers l’emplacement où le premier handle radio énuméré sera retourné. Lorsqu’il n’est plus nécessaire, ce handle doit être fermé via CloseHandle.
Valeur retournée
En plus du handle indiqué par phRadio, l’appel de cette fonction crée également un handle HBLUETOOTH_RADIO_FIND à utiliser avec la fonction BluetoothFindNextRadio . Lorsque ce handle n’est plus nécessaire, il doit être fermé via BluetoothFindRadioClose.
Retourne NULL en cas d’échec. Appelez la fonction GetLastError pour plus d’informations sur l’erreur. Le tableau suivant décrit les erreurs courantes :
Code de retour | Description |
---|---|
|
Aucune radio Bluetooth trouvée. |
|
Le paramètre pbtfrp est NULL. |
|
La structure pointée vers pbtfrp n’est pas la taille correcte. |
|
Mémoire insuffisante. |
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 |