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
ERROR_NO_MORE_ITEMS	Aucune radio Bluetooth trouvée.
ERROR_INVALID_PARAMETER	Le paramètre pbtfrp est NULL.
ERROR_REVISION_MISMATCH	La structure pointée vers pbtfrp n’est pas la taille correcte.
ERROR_OUTOFMEMORY	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

Voir aussi

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

Obtenir la dernière erreur