bluetoothapis.h 标头

此标头由多种技术使用。 有关详细信息，请参阅：

• 蓝牙
• 蓝牙设备参考

bluetoothapis.h 包含以下编程接口：

函数

BluetoothAuthenticateDevice 将身份验证请求发送到远程蓝牙设备。
BluetoothAuthenticateDeviceEx BluetoothAuthenticateDeviceEx 函数将身份验证请求发送到远程蓝牙设备。
BluetoothAuthenticateMultipleDevices 使调用方能够在蓝牙连接向导的单个实例期间提示对多个设备进行身份验证。
BluetoothDisplayDeviceProperties 启动控制面板设备信息属性表。
BluetoothEnableDiscovery BluetoothEnableDiscovery 函数更改本地蓝牙无线电或无线电的发现状态。
BluetoothEnableIncomingConnections BluetoothEnableIncomingConnections 函数修改本地蓝牙无线电是否接受传入连接。
BluetoothEnumerateInstalledServices BluetoothEnumerateInstalledServices 函数枚举在蓝牙设备上启用的服务 GUID (全局唯一标识符) 。
BluetoothFindDeviceClose BluetoothFindDeviceClose 函数关闭与设备查询关联的枚举句柄。
BluetoothFindFirstDevice BluetoothFindFirstDevice 函数开始枚举蓝牙设备。
BluetoothFindFirstRadio BluetoothFindFirstRadio 函数开始枚举本地蓝牙无线电。
BluetoothFindNextDevice BluetoothFindNextDevice 函数查找下一个蓝牙设备。
BluetoothFindNextRadio BluetoothFindNextRadio 函数查找下一个蓝牙无线电。
BluetoothFindRadioClose BluetoothFindRadioClose 函数关闭与查找蓝牙无线电关联的枚举句柄。
BluetoothGetDeviceInfo 检索有关远程蓝牙设备的信息。
BluetoothGetRadioInfo 获取有关蓝牙无线电的信息。
BluetoothIsConnectable BluetoothIsConnectable 函数确定蓝牙无线电或无线电是否可连接。
BluetoothIsDiscoverable BluetoothIsDiscoverable 函数确定蓝牙无线电或无线电是否可发现。
BluetoothIsVersionAvailable BluetoothIsVersionAvailable 函数指示已安装的蓝牙二进制文件集是否支持请求的版本。
BluetoothRegisterForAuthentication BluetoothRegisterForAuthentication 函数注册当特定蓝牙设备请求身份验证时调用的回调函数。
BluetoothRegisterForAuthenticationEx BluetoothRegisterForAuthenticationEx 函数为 Pin 请求、数字比较和回调函数注册应用程序。
BluetoothRemoveDevice 删除蓝牙设备和计算机之间的身份验证，并清除设备的缓存服务信息。
BluetoothSdpEnumAttributes BluetoothSdpEnumAttributes 函数通过 SDP 记录流枚举，并为记录中的每个属性调用回调函数。
BluetoothSdpGetAttributeValue BluetoothSdpGetAttributeValue 函数检索属性标识符的属性值。
BluetoothSdpGetContainerElementData 循环访问容器流并返回容器元素中包含的每个元素。
BluetoothSdpGetElementData 从 SDP 流中检索和分析单个元素。
BluetoothSdpGetString 将 SDP 记录中嵌入的原始字符串转换为 Unicode 字符串。
BluetoothSelectDevices 启用蓝牙设备选择。
BluetoothSelectDevicesFree 释放与之前调用 BluetoothSelectDevices 关联的资源。
BluetoothSendAuthenticationResponse 收到发送密钥响应的身份验证请求时，将调用 BluetoothSendAuthenticationResponse 函数。
BluetoothSendAuthenticationResponseEx 当发送密钥的身份验证请求或进行数字比较响应时，将调用 BluetoothSendAuthenticationResponseEx 函数。
BluetoothSetLocalServiceInfo 设置特定蓝牙无线电的本地服务信息。
BluetoothSetServiceState 启用或禁用蓝牙设备的服务。
BluetoothUnregisterAuthentication BluetoothUnregisterAuthentication 函数删除以前通过调用 BluetoothRegisterForAuthentication 函数注册的回调例程的注册。
BluetoothUpdateDeviceRecord 汇报有关蓝牙设备的本地计算机缓存。

回调函数

PFN_AUTHENTICATION_CALLBACK 与 BluetoothRegisterForAuthentication 函数结合使用。
PFN_AUTHENTICATION_CALLBACK_EX PFN_AUTHENTICATION_CALLBACK_EX 函数是与 BluetoothRegisterForAuthenticationEx 函数结合使用的回调函数原型。
PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK 一个回调函数原型，为传递到 BluetoothSdpEnumAttributes 函数调用的 pSDPStream 参数中找到的每个属性调用一次。
PFN_DEVICE_CALLBACK 与选择蓝牙设备关联的回调原型。

结构

BLUETOOTH_ADDRESS_STRUCT BLUETOOTH_ADDRESS结构提供蓝牙设备的地址。
BLUETOOTH_AUTHENTICATE_RESPONSE BLUETOOTH_AUTHENTICATE_RESPONSE结构包含为响应BTH_REMOTE_AUTHENTICATE_REQUEST事件而传递的信息。
BLUETOOTH_AUTHENTICATION_CALLBACK_PARAMS BLUETOOTH_AUTHENTICATION_CALLBACK_PARAMS结构包含有关响应身份验证请求的蓝牙设备的特定配置信息。
BLUETOOTH_COD_PAIRS BLUETOOTH_COD_PAIRS结构提供规范和检索蓝牙类设备 (COD) 信息。
BLUETOOTH_DEVICE_INFO_STRUCT BLUETOOTH_DEVICE_INFO结构提供有关蓝牙设备的信息。
BLUETOOTH_DEVICE_SEARCH_PARAMS 指定蓝牙设备搜索的搜索条件。
BLUETOOTH_FIND_RADIO_PARAMS BLUETOOTH_FIND_RADIO_PARAMS结构有助于枚举已安装的蓝牙无线电。
BLUETOOTH_LOCAL_SERVICE_INFO_STRUCT 包含蓝牙设备的本地服务信息。
BLUETOOTH_NUMERIC_COMPARISON_INFO BLUETOOTH_NUMERIC_COMPARISON_INFO 结构包含用于通过数字比较进行身份验证的数值。
BLUETOOTH_OOB_DATA_INFO BLUETOOTH_OOB_DATA_INFO结构包含用于在建立带外设备配对之前进行身份验证的数据。
BLUETOOTH_PASSKEY_INFO BLUETOOTH_PASSKEY_INFO结构包含用于身份验证的密钥值。 密钥类似于密码，只是密钥值仅用于身份验证一次。
BLUETOOTH_PIN_INFO BLUETOOTH_PIN_INFO结构包含用于通过 PIN 进行身份验证的信息。
BLUETOOTH_RADIO_INFO 包含有关蓝牙无线电的信息。
BLUETOOTH_SELECT_DEVICE_PARAMS 促进和管理蓝牙设备和服务的可见性、身份验证和选择。
SDP_ELEMENT_DATA SDP_ELEMENT_DATA结构存储 SDP 元素数据。
SDP_STRING_TYPE_DATA SDP_STRING_TYPE_DATA结构存储有关 SDP 字符串类型的信息。

枚举

BLUETOOTH_AUTHENTICATION_METHOD BLUETOOTH_AUTHENTICATION_METHOD枚举定义设备配对期间支持的身份验证类型。
BLUETOOTH_AUTHENTICATION_REQUIREMENTS BLUETOOTH_AUTHENTICATION_REQUIREMENTS枚举指定身份验证所需的“中间人”保护。
BLUETOOTH_IO_CAPABILITY BLUETOOTH_IO_CAPABILITY枚举定义蓝牙设备的输入/输出功能。