BluetoothAuthenticateDeviceEx 函数是 Windows 中用于对蓝牙设备进行身份验证的扩展函数。与 BluetoothAuthenticateDevice 不同,BluetoothAuthenticateDeviceEx 允许提供更多的参数以支持更复杂的身份验证场景。

以下是 BluetoothAuthenticateDeviceEx 函数的声明:
DWORD BluetoothAuthenticateDeviceEx(
  HWND                    hwndParentIn,
  HANDLE                  hRadioIn,
  BLUETOOTH_DEVICE_INFO   *pbtdiInout,
  PBLUETOOTH_OOB_DATA     pbtOobData,
  AUTHENTICATION_REQUIREMENTS authenticationRequirement,
  LPWSTR                  pszPasskey,
  ULONG                   cPasskey
);

参数说明:
  •  hwndParentIn: 指定用于用户交互的父窗口的句柄。如果不需要用户交互,则可以将其设置为 NULL。

  •  hRadioIn: 本地蓝牙无线电的句柄。可以使用 BluetoothFindFirstRadio 函数获取。

  •  pbtdiInout: 指向 BLUETOOTH_DEVICE_INFO 结构的指针,包含要验证的蓝牙设备的信息。此参数还用于返回验证后的设备信息。

  •  pbtOobData: 指向 BLUETOOTH_OOB_DATA 结构的指针,包含蓝牙设备的 Out-of-Band 数据。如果不使用 OOB 数据,则可以将其设置为 NULL。

  •  authenticationRequirement: 一个枚举值,指定身份验证的要求。

  •  pszPasskey: 用于验证的 PIN 码。如果不需要 PIN 码验证,可以将其设置为 NULL。

  •  cPasskey: 如果使用 PIN 码验证,此参数指定 PIN 码的长度。如果不使用 PIN 码验证,可以将其设置为 0。


函数返回一个 DWORD 类型的错误代码。如果返回 ERROR_SUCCESS,表示身份验证成功。其他错误代码可以帮助确定身份验证失败的原因。

请注意,使用此函数需要管理员权限。确保在调用此函数之前,您的应用程序已经获取了适当的权限。




转载请注明出处:http://www.zyzy.cn/article/detail/24059/Win32 API/Bluetoothapis.h/BluetoothAuthenticateDeviceEx