Поделиться через

Функция 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:

Flag Описание
BLUETOOTH_GATT_FLAG_NONE Клиент не предъявляет особых требований к GATT (по умолчанию).

Возвращаемое значение

Функция BluetoothGATTBeginReliableWrite возвращает следующие значения:

Код возврата Описание
S_OK
 Операция выполнена успешно.
ERROR_ACCESS_DENIED
 Возвращается, если предоставляются родительская служба и дескриптор службы, а иерархия служб не выполняет сверты до предоставленного дескриптора родительской службы.
ERROR_INVALID_FUNCTION
 В настоящее время уже выполняется надежная операция записи.

Комментарии

Функция BluetoothGATTBeginReliableWrite уведомляет стек Bluetooth о том, что процедуры, вызываемые после возврата функции, являются надежными операциями записи. Все операции, которые не поддерживают надежные операции записи, возвращают ошибку 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
Библиотека BluetoothAPIs.lib
DLL BluetoothAPIs.dll