Edit

BluetoothFindNextRadio function (bluetoothapis.h)

  • Article

The BluetoothFindNextRadio function finds the next Bluetooth radio.

Syntax

BOOL BluetoothFindNextRadio(
  [in]  HBLUETOOTH_RADIO_FIND hFind,
  [out] HANDLE                *phRadio
);

Parameters

[in] hFind

Handle returned by a previous call to the BluetoothFindFirstRadio function. Use BluetoothFindRadioClose to close this handle when it is no longer needed.

[out] phRadio

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

Return value

Returns TRUE when the next available radio is found.

Returns FALSE when no new radios are found. Call the GetLastError function for more information on the error. The following table describe common errors:

Return code Description
ERROR_INVALID_HANDLE
 The handle is NULL.
ERROR_NO_MORE_ITEMS
 No more radios were found.
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

BluetoothFindFirstRadio

BluetoothFindRadioClose

BluetoothGetRadioInfo

GetLastError