BluetoothGetRadioInfo function (bluetoothapis.h)

The BluetoothGetRadioInfo function obtains information about a Bluetooth radio.

Syntax

DWORD BluetoothGetRadioInfo(
  HANDLE                hRadio,
  PBLUETOOTH_RADIO_INFO pRadioInfo
);

Parameters

hRadio

A handle to a local Bluetooth radio, obtained by calling the BluetoothFindFirstRadio or similar functions, or the SetupDiEnumerateDeviceInterfances function.

pRadioInfo

A pointer to a BLUETOOTH_RADIO_INFO structure into which information about the radio will be placed. The dwSize member of the BLUETOOTH_RADIO_INFO structure must match the size of the structure.

Return value

The following table lists common return values.

Return code Description
ERROR_SUCCESS
The radio information was retrieved successfully.
ERROR_INVALID_PARAMETER
The hRadio or pRadioInfo parameter is NULL.
ERROR_REVISION_MISMATCH
The dwSize member of the BLUETOOTH_RADIO_INFO structure pointed to by pRadioInfo is not valid.

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

BluetoothFindFirstRadio

BluetoothFindNextRadio

BluetoothFindRadioClose

GetLastError