Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

BluetoothAuthenticateMultipleDevices function

The BluetoothAuthenticateMultipleDevices function enables the caller to prompt for multiple devices to be authenticated during a single instance of the Bluetooth Connection wizard.

Note  BluetoothAuthenticateMultipleDevices has been deprecated. Implementation of this API is not recommended.

Syntax


DWORD BluetoothAuthenticateMultipleDevices(
  HWND hwndParent,
  HANDLE hRadio,
  DWORD cDevices,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parameters

hwndParent

A window to be the parent of the Authentication wizard. If set to NULL, the wizard is parented off the desktop.

hRadio

The valid local radio handle, or NULL. If NULL, authentication is attempted on all local radios; if any radio succeeds, the function call succeeds.

cDevices

The number of devices in the pbtdi array of BLUETOOTH_DEVICE_INFO structures.

pbtdi

An array of BLUETOOTH_DEVICE_INFO structures that contain records for the Bluetooth devices to be authenticated.

Return value

Returns ERROR_SUCCESS upon successful completion; check the fAuthenticate flag for each device.

The following table lists common errors.

Return codeDescription
ERROR_CANCELLED

The user canceled the operation. Check the fAuthenticate flag for each Bluetooth device to determine whether any devices were authenticated before the user canceled the operation.

ERROR_INVALID_PARAMETER

One or more of the devices in the pbtdi array was not valid.

ERROR_NO_MORE_ITEMS

All devices pointed to by pbtdi are already marked as authenticated.

 

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

None supported

Header

BluetoothAPIs.h (include Bthsdpdef.h or BluetoothAPIs.h)

Library

Bthprops.lib

DLL

Bthprops.dll

See also

BluetoothEnableDiscovery
BluetoothEnableIncomingConnections
BluetoothIsConnectable
BluetoothIsDiscoverable
BluetoothSendAuthenticationResponse
BluetoothRegisterForAuthentication
BluetoothUnregisterAuthentication
BLUETOOTH_DEVICE_INFO

 

 

Community Additions

Show:
© 2014 Microsoft