BLUETOOTH_SELECT_DEVICE_PARAMS structure (bluetoothapis.h)

The BLUETOOTH_SELECT_DEVICE_PARAMS structure facilitates and manages the visibility, authentication, and selection of Bluetooth devices and services.

Syntax

typedef struct _BLUETOOTH_SELECT_DEVICE_PARAMS {
  DWORD                  dwSize;
  ULONG                  cNumOfClasses;
  BLUETOOTH_COD_PAIRS    *prgClassOfDevices;
  LPWSTR                 pszInfo;
  HWND                   hwndParent;
  BOOL                   fForceAuthentication;
  BOOL                   fShowAuthenticated;
  BOOL                   fShowRemembered;
  BOOL                   fShowUnknown;
  BOOL                   fAddNewDeviceWizard;
  BOOL                   fSkipServicesPage;
  PFN_DEVICE_CALLBACK    pfnDeviceCallback;
  LPVOID                 pvParam;
  DWORD                  cNumDevices;
  PBLUETOOTH_DEVICE_INFO pDevices;
} BLUETOOTH_SELECT_DEVICE_PARAMS;

Members

dwSize

Size, in bytes, of the BLUETOOTH_SELECT_DEVICE_PARAMS structure.

cNumOfClasses

Number of classes in prgClassOfDevices. Set to zero to search for all devices.

prgClassOfDevices

Array of class of devices to find.

pszInfo

Sets the information text when not NULL.

hwndParent

Handle to the parent window. Set to NULL for no parent.

fForceAuthentication

If TRUE, forces authentication before returning.

fShowAuthenticated

If TRUE, authenticated devices are shown in the picker.

fShowRemembered

If TRUE, remembered devices are shown in the picker.

fShowUnknown

If TRUE, unknown devices that are not authenticated or remembered are shown in the picker.

fAddNewDeviceWizard

If TRUE, starts the Add New Device wizard.

fSkipServicesPage

If TRUE, skips the Services page in the Add New Device wizard.

pfnDeviceCallback

A pointer to a callback function that is called for each device. If the callback function returns TRUE, the item is added. If the callback function returns FALSE, the item is not shown. Set pfnDeviceCallback to null for no callback. For more information, see PFN_DEVICE_CALLBACK.

pvParam

Parameter to be passed as pvParam to the callback function pointed to in pfnDeviceCallback.

cNumDevices

On input, specifies the number of desired calls. Set to zero for no limit. On output, returns the number of devices returned.

pDevices

Pointer to an array of BLUETOOTH_DEVICE_INFO structures.

Remarks

To free the array of BLUETOOTH_DEVICE_INFO structures passed in the pDevices member, call the BluetoothSelectDevicesFree function.

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

BLUETOOTH_COD_PAIRS

BLUETOOTH_DEVICE_INFO

BluetoothSelectDevices

BluetoothSelectDevicesFree

PFN_DEVICE_CALLBACK