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

Функция BluetoothGATTEndReliableWrite (bluetoothleapis.h)

  • Статья

Функция BluetoothGATTEndReliableWrite указывает конец надежных операций записи, и записи должны быть зафиксированы.

Синтаксис

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

Параметры

[in] hDevice

Дескриптор для службы.

[in] ReliableWriteContext

Контекст, описывающий надежную операцию записи, возвращенную при предыдущем вызове BluetoothGATTBeginReliableWrite.

[in] Flags

Флаги для изменения поведения BluetoothGATTEndReliableWrite:

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

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

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

Код возврата Описание
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
Библиотека BluetoothAPIs.lib
DLL BluetoothAPIs.dll