通过

BluetoothGATTBeginReliableWrite 函数 (bluetoothleapis.h)

  • 项目

BluetoothGATTBeginReliableWrite 函数指定可靠写入即将开始。

语法

HRESULT BluetoothGATTBeginReliableWrite(
  [in]  HANDLE                              hDevice,
  [out] PBTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext,
  [in]  ULONG                               Flags
);

参数

[in] hDevice

服务的句柄。

[out] ReliableWriteContext

包含描述可靠写入操作的上下文 的BTH_LE_GATT_RELIABLE_WRITE_CONTEXT 结构的地址。

[in] Flags

用于修改 BluetoothGATTBeginReliableWrite 行为的标志：

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

返回值

BluetoothGATTBeginReliableWrite 函数返回以下值：

返回代码 说明
S_OK
 操作已成功完成。
ERROR_ACCESS_DENIED
 如果同时提供了父服务和服务句柄，并且服务层次结构不汇总到提供的父服务句柄，则返回 。
ERROR_INVALID_FUNCTION
 可靠的写入操作目前正在进行中。

注解

BluetoothGATTBeginReliableWrite 函数通知蓝牙堆栈，在函数返回后要调用的过程是可靠的写入操作。 任何不支持可靠写入的操作都将返回 ERROR_INVALID_FUNCTION 错误。 只有以下函数支持可靠的写入操作：

示例


BTH_LE_GATT_RELIABLE_WRITE_CONTEXT ReliableWriteContext = NULL;
hr = BluetoothGATTBeginReliableWrite(hDevice, 
                                    &ReliableWriteContext,
                                    BLUETOOTH_GATT_FLAG_NONE);

if (SUCCEEDED(hr)) {
    // Calls to BluetoothGATTSetCharacteristicValue
}

if (NULL != ReliableWriteContext) {
    BluetoothGATTEndReliableWrite(hDevice, 
                                 ReliableWriteContext,
                                  BLUETOOTH_GATT_FLAG_NONE);
}

要求

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