BluetoothGATTBeginReliableWrite-Funktion (bluetoothleapis.h)

Artikel
02/23/2024

Die BluetoothGATTBeginReliableWrite-Funktion gibt an, dass zuverlässige Schreibvorgänge beginnen.

Syntax

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

Parameter

[in] hDevice

Handle mit dem Dienst.

[out] ReliableWriteContext

Adresse einer BTH_LE_GATT_RELIABLE_WRITE_CONTEXT Struktur, die den Kontext enthält, der den zuverlässigen Schreibvorgang beschreibt.

[in] Flags

Flags zum Ändern des Verhaltens von BluetoothGATTBeginReliableWrite:

Flag	Beschreibung
BLUETOOTH_GATT_FLAG_NONE	Der Client hat keine spezifischen GATT-Anforderungen (Standard).

Rückgabewert

Die BluetoothGATTBeginReliableWrite-Funktion gibt die folgenden Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich abgeschlossen.
ERROR_ACCESS_DENIED	Wird zurückgegeben, wenn sowohl ein übergeordneter Dienst als auch ein Diensthandle bereitgestellt werden und die Diensthierarchie kein Rollup zum bereitgestellten übergeordneten Diensthandle durchführt.
ERROR_INVALID_FUNCTION	Ein zuverlässiger Schreibvorgang wird bereits ausgeführt.

Hinweise

Die BluetoothGATTBeginReliableWrite-Funktion benachrichtigt den Bluetooth-Stapel darüber, dass Prozeduren, die nach der Funktionsrückführung aufgerufen werden sollen, zuverlässige Schreibvorgänge sind. Alle Vorgänge, die keine zuverlässigen Schreibvorgänge unterstützen, geben einen ERROR_INVALID_FUNCTION Fehler zurück. Nur die folgenden Funktionen unterstützen zuverlässige Schreibvorgänge:

Beispiele


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);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Wird in Windows 8 und höheren Versionen von Windows unterstützt.
Zielplattform	Universell
Header	bluetoothleapis.h
Bibliothek	BluetoothAPIs.lib
DLL	BluetoothAPIs.dll

Freigeben über