BluetoothFindFirstRadio function (bluetoothapis.h)

The BluetoothFindFirstRadio function begins the enumeration of local Bluetooth radios.

Syntax

HBLUETOOTH_RADIO_FIND BluetoothFindFirstRadio(
        const BLUETOOTH_FIND_RADIO_PARAMS *pbtfrp,
  [out] HANDLE                            *phRadio
);

Parameters

pbtfrp

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.

[out] phRadio

Pointer to where the first enumerated radio handle will be returned. When no longer needed, this handle must be closed via CloseHandle.

Return value

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:

Return code	Description
ERROR_NO_MORE_ITEMS	No Bluetooth radios found.
ERROR_INVALID_PARAMETER	The pbtfrp parameter is NULL.
ERROR_REVISION_MISMATCH	The structure pointed to by pbtfrp is not the correct size.
ERROR_OUTOFMEMORY	Out of memory.

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
DLL	bthprops.cpl

See also

BLUETOOTH_FIND_RADIO_PARAMS

BluetoothFindNextRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError