The BluetoothFindFirstRadio function begins the enumeration of local Bluetooth radios.
HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio( const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp, HANDLE *phRadio );
Pointer to a BLUETOOTH_FIND_RADIO_PARAMS structure. The dwSize member of the BLUETOOTH_FIND_RADIO_PARAMS structure pointed to by pbtfrp must match the size of the structure.
Pointer to where the first enumerated radio handle will be returned. When no longer needed, this handle must be closed via CloseHandle.
In addition to the handle indicated by phRadio, calling this function will also create a HBLUETOOTH_RADIO_FIND handle for use with the BluetoothFindNextRadio function. When this handle is no longer needed, it must be closed via the BluetoothFindRadioClose.
Returns NULL upon failure. Call the GetLastError function for more information on the error. The following table describe common errors:
||No Bluetooth radios found.|
||The pbtfrp parameter is NULL.|
||The structure pointed to by pbtfrp is not the correct size.|
||Out of memory.|
|Minimum supported client||Windows Vista, Windows XP with SP2 [desktop apps only]|
|Minimum supported server||None supported|
|Header||bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)|