通过

BluetoothGATTAbortReliableWrite 函数 (bluetoothleapis.h)

  • 项目

BluetoothGATTAbortReliableWrite 函数指定可靠写入过程的结束时间，应中止写入。

语法

HRESULT BluetoothGATTAbortReliableWrite(
  [in] HANDLE                             hDevice,
  [in] BTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext,
  [in] ULONG                              Flags
);

参数

[in] hDevice

服务的句柄。

[in] ReliableWriteContext

描述从之前调用 BluetoothGATTBeginReliableWrite 返回的可靠写入操作的上下文。

[in] Flags

用于修改 BluetoothGATTAbortReliableWrite 行为的标志：

标志 描述
BLUETOOTH_GATT_FLAG_NONE 客户端没有特定的 GATT 要求 (默认) 。

返回值

BluetoothGATTAbortReliableWrite 函数返回以下值：

返回代码 说明
S_OK
 操作已成功完成。
ERROR_ACCESS_DENIED
 如果同时提供了父服务和服务句柄，并且服务层次结构不汇总到提供的父服务句柄，则返回 。
ERROR_INVALID_FUNCTION
 可靠写入操作目前尚未进行。
ERROR_BAD_NET_RESP
 目标服务器未提供适当的网络响应。
ERROR_SEM_TIMEOUT
 请求超时。
ERROR_NO_SYSTEM_RESOURCES
 操作内存不足。
E_BLUETOOTH_ATT_INVALID_HANDLE
 给定的属性句柄在此服务器上无效。
E_BLUETOOTH_ATT_READ_NOT_PERMITTED
 无法读取属性。
E_BLUETOOTH_ATT_WRITE_NOT_PERMITTED
 无法写入特性。
E_BLUETOOTH_ATT_INVALID_PDU
 属性 PDU 无效。
E_BLUETOOTH_ATT_INSUFFICIENT_AUTHENTICATION
 属性需要身份验证，然后才能读取或写入该属性。
E_BLUETOOTH_ATT_REQUEST_NOT_SUPPORTED
 属性服务器不支持从客户端收到的请求。
E_BLUETOOTH_ATT_INVALID_OFFSET
 指定的偏移量超过属性的末尾。
E_BLUETOOTH_ATT_INSUFFICIENT_AUTHORIZATION
 属性需要授权才能读取或写入。
E_BLUETOOTH_ATT_PREPARE_QUEUE_FULL
 太多准备写入已排队。
E_BLUETOOTH_ATT_ATTRIBUTE_NOT_FOUND
 在给定的属性句柄范围内找不到任何属性。
E_BLUETOOTH_ATT_ATTRIBUTE_NOT_LONG
 不能使用读取 Blob 请求读取或写入属性。
E_BLUETOOTH_ATT_INSUFFICIENT_ENCRYPTION_KEY_SIZE
 用于加密此链接的加密密钥大小不足。
E_BLUETOOTH_ATT_INVALID_ATTRIBUTE_VALUE_LENGTH
 属性值长度对于操作无效。
E_BLUETOOTH_ATT_UNLIKELY
 请求的属性请求遇到不太可能的错误，因此无法按请求完成。
E_BLUETOOTH_ATT_INSUFFICIENT_ENCRYPTION
 属性需要加密，然后才能读取或写入该属性。
E_BLUETOOTH_ATT_UNSUPPORTED_GROUP_TYPE
 属性类型不是更高层规范所定义的受支持的分组属性。
E_BLUETOOTH_ATT_INSUFFICIENT_RESOURCES
 资源不足，无法完成请求。
E_BLUETOOTH_ATT_UNKNOWN_ERROR
 已收到位于保留范围内的错误。

要求

要求 值
最低受支持的客户端 在 Windows 8 及更高版本的 Windows 中受支持。
目标平台 通用
标头 bluetoothleapis.h
Library BluetoothAPIs.lib
DLL BluetoothAPIs.dll