BluetoothAuthenticateMultipleDevices 函式 (bluetoothapis.h)

發行項
02/26/2024

BluetoothAuthenticateMultipleDevices 函式可讓呼叫者提示在藍牙聯機精靈的單一實例期間驗證多個裝置。

注意BluetoothAuthenticateMultipleDevices 已被取代。不建議實作此 API。

語法

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

參數

hwndParent

做為驗證精靈父系的視窗。如果設定為 NULL，精靈會從桌面上系。

hRadio

有效的本機單選句柄或 NULL。如果 為 NULL，則會在所有本機無線電上嘗試驗證;如果有任何無線電成功，函數調用就會成功。

cDevices

BLUETOOTH_DEVICE_INFO 結構的 pbtdi 陣列中的裝置數目。

rgbtdi

BLUETOOTH_DEVICE_INFO 結構的陣列，其中包含要驗證之藍牙裝置的記錄。

傳回值

成功完成時 傳回ERROR_SUCCESS ;檢查每個裝置的 fAuthenticate 旗標。

下表列出常見的錯誤。

傳回碼	Description
ERROR_CANCELLED	使用者已取消作業。檢查每個藍牙裝置的 fAuthenticate 旗標，以判斷使用者取消作業之前是否已驗證任何裝置。
ERROR_INVALID_PARAMETER	pbtdi 陣列中的一或多個裝置無效。
ERROR_NO_MORE_ITEMS	pbtdi 指向的所有裝置都已標示為已驗證。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
程式庫	Bthprops.lib
Dll	bthprops.cpl