BluetoothAuthenticateMultipleDevices function (bluetoothapis.h)
The BluetoothAuthenticateMultipleDevices function enables the caller to prompt for multiple devices to be authenticated during a single instance of the Bluetooth Connection wizard.
Syntax
DWORD BluetoothAuthenticateMultipleDevices(
HWND hwndParent,
HANDLE hRadio,
DWORD cDevices,
BLUETOOTH_DEVICE_INFO *rgbtdi
);
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.
rgbtdi
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 code | Description |
|---|---|
|
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. |
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
BluetoothEnableIncomingConnections
BluetoothRegisterForAuthentication