The BluetoothAuthenticateMultipleDevices function enables the caller to prompt for multiple devices to be authenticated during a single instance of the Bluetooth Connection wizard.
DWORD BluetoothAuthenticateMultipleDevices( HWND hwndParent, HANDLE hRadio, DWORD cDevices, BLUETOOTH_DEVICE_INFO *rgbtdi );
A window to be the parent of the Authentication wizard. If set to NULL, the wizard is parented off the desktop.
The valid local radio handle, or NULL. If NULL, authentication is attempted on all local radios; if any radio succeeds, the function call succeeds.
The number of devices in the pbtdi array of BLUETOOTH_DEVICE_INFO structures.
An array of BLUETOOTH_DEVICE_INFO structures that contain records for the Bluetooth devices to be authenticated.
Returns ERROR_SUCCESS upon successful completion; check the fAuthenticate flag for each device.
The following table lists common errors.
||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.|
||One or more of the devices in the pbtdi array was not valid.|
||All devices pointed to by pbtdi are already marked as authenticated.|
|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)|