BLUETOOTH_DEVICE_SEARCH_PARAMS structure (bluetoothapis.h)

The BLUETOOTH_DEVICE_SEARCH_PARAMS structure specifies search criteria for Bluetooth device searches.

Syntax

typedef struct _BLUETOOTH_DEVICE_SEARCH_PARAMS {
  DWORD  dwSize;
  BOOL   fReturnAuthenticated;
  BOOL   fReturnRemembered;
  BOOL   fReturnUnknown;
  BOOL   fReturnConnected;
  BOOL   fIssueInquiry;
  UCHAR  cTimeoutMultiplier;
  HANDLE hRadio;
} BLUETOOTH_DEVICE_SEARCH_PARAMS;

Members

dwSize

The size, in bytes, of the structure.

fReturnAuthenticated

A value that specifies that the search should return authenticated Bluetooth devices.

fReturnRemembered

A value that specifies that the search should return remembered Bluetooth devices.

fReturnUnknown

A value that specifies that the search should return unknown Bluetooth devices.

fReturnConnected

A value that specifies that the search should return connected Bluetooth devices.

fIssueInquiry

A value that specifies that a new inquiry should be issued.

cTimeoutMultiplier

A value that indicates the time out for the inquiry, expressed in increments of 1.28 seconds. For example, an inquiry of 12.8 seconds has a cTimeoutMultiplier value of 10. The maximum value for this member is 48. When a value greater than 48 is used, the calling function immediately fails and returns E_INVALIDARG.

hRadio

A handle for the radio on which to perform the inquiry. Set to NULL to perform the inquiry on all local Bluetooth radios.

Requirements

Requirement Value
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)

See also

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothGetDeviceInfo

BluetoothRemoveDevice

BluetoothUpdateDeviceRecord