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

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

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