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 支援。
目標平台 Universal
標頭 bluetoothleapis.h
程式庫 BluetoothAPIs.lib
Dll BluetoothAPIs.dll