Condividi tramite


Funzione BluetoothGATTSetDescriptorValue (bluetoothleapis.h)

La funzione BluetoothGATTSetDescriptorValue scrive il valore descrittore specificato nel dispositivo Bluetooth.

Sintassi

HRESULT BluetoothGATTSetDescriptorValue(
  [in] HANDLE                        hDevice,
  [in] PBTH_LE_GATT_DESCRIPTOR       Descriptor,
  [in] PBTH_LE_GATT_DESCRIPTOR_VALUE DescriptorValue,
  [in] ULONG                         Flags
);

Parametri

[in] hDevice

Gestire il servizio.

[in] Descriptor

Puntatore al descrittore padre.

[in] DescriptorValue

Puntatore al valore del descrittore.

[in] Flags

Flag per modificare il comportamento di BluetoothGATTSetDescriptorValue:

Flag Descrizione
BLUETOOTH_GATT_FLAG_NONE Il client non ha requisiti GATT specifici (impostazione predefinita).
BLUETOOTH_GATT_FLAG_CONNECTION_ENCRYPTED Il client richiede la trasmissione dei dati su un canale crittografato.
BLUETOOTH_GATT_FLAG_CONNECTION_AUTHENTICATED Il client richiede che i dati vengano trasmessi tramite un canale autenticato.

Valore restituito

La funzione BluetoothGATTSetDescriptorValue restituisce i valori seguenti:

Codice restituito Descrizione
S_OK
Operazione riuscita.
ERROR_ACCESS_DENIED
Restituito se vengono forniti sia un servizio padre che un handle di servizio e la gerarchia del servizio non viene implementata nell'handle del servizio padre fornito.
ERROR_INVALID_PARAMETER
Parametro non valido.
ERROR_BAD_NET_RESP
Il server di destinazione non ha fornito una risposta di rete appropriata.
ERROR_SEM_TIMEOUT
Timeout della richiesta.
ERROR_NO_SYSTEM_RESOURCES
L'operazione ha esaurito la memoria.
E_BLUETOOTH_ATT_INVALID_HANDLE
L'handle dell'attributo specificato non è valido in questo server.
E_BLUETOOTH_ATT_READ_NOT_PERMITTED
Impossibile leggere l'attributo.
E_BLUETOOTH_ATT_WRITE_NOT_PERMITTED
Impossibile scrivere l'attributo.
E_BLUETOOTH_ATT_INVALID_PDU
L'attributo PDU non è valido.
E_BLUETOOTH_ATT_INSUFFICIENT_AUTHENTICATION
L'attributo richiede l'autenticazione prima di poter essere letto o scritto.
E_BLUETOOTH_ATT_REQUEST_NOT_SUPPORTED
Il server attributi non supporta la richiesta ricevuta dal client.
E_BLUETOOTH_ATT_INVALID_OFFSET
L'offset specificato è passato alla fine dell'attributo.
E_BLUETOOTH_ATT_INSUFFICIENT_AUTHORIZATION
L'attributo richiede l'autorizzazione prima di poter essere letto o scritto.
E_BLUETOOTH_ATT_PREPARE_QUEUE_FULL
Troppe scritture di preparazione sono state accodate.
E_BLUETOOTH_ATT_ATTRIBUTE_NOT_FOUND
Nessun attributo trovato all'interno dell'intervallo di handle di attributi specificato.
E_BLUETOOTH_ATT_ATTRIBUTE_NOT_LONG
L'attributo non può essere letto o scritto usando la richiesta BLOB di lettura.
E_BLUETOOTH_ATT_INSUFFICIENT_ENCRYPTION_KEY_SIZE
Le dimensioni della chiave di crittografia usate per crittografare questo collegamento non sono sufficienti.
E_BLUETOOTH_ATT_INVALID_ATTRIBUTE_VALUE_LENGTH
La lunghezza del valore dell'attributo non è valida per l'operazione.
E_BLUETOOTH_ATT_UNLIKELY
La richiesta di attributo richiesta ha rilevato un errore improbabile e pertanto non è stato possibile completare come richiesto.
E_BLUETOOTH_ATT_INSUFFICIENT_ENCRYPTION
L'attributo richiede la crittografia prima di poter essere letto o scritto.
E_BLUETOOTH_ATT_UNSUPPORTED_GROUP_TYPE
Il tipo di attributo non è un attributo di raggruppamento supportato come definito da una specifica di livello superiore.
E_BLUETOOTH_ATT_INSUFFICIENT_RESOURCES
Risorse insufficienti per completare la richiesta.
E_BLUETOOTH_ATT_UNKNOWN_ERROR
Errore che si trova nell'intervallo riservato ricevuto.

Commenti

Il descrittore padre deve essere restituito da una chiamata precedente a BluetoothGATTGetDescriptors e non deve essere modificato. Il comportamento non è definito se il chiamante esegue questa operazione.

Esempio


BTH_LE_GATT_DESCRIPTOR_VALUE newValue;

RtlZeroMemory(&newValue, sizeof(newValue));

newValue.DescriptorType = ClientCharacteristicConfiguration;
newValue.ClientCharacteristicConfiguration.IsSubscribeToNotification = TRUE;

// Subscribe to an event.
hr = BluetoothGATTSetDescriptorValue(hDevice, 
                                parentDescriptor, 
                                &newValue,
                                BLUETOOTH_GATT_FLAG_NONE);

Requisiti

Requisito Valore
Client minimo supportato Supportato in Windows 8 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione bluetoothleapis.h
Libreria BluetoothApis.lib
DLL BluetoothAPIs.dll

Vedi anche

BTH_LE_GATT_DESCRIPTOR

BTH_LE_GATT_DESCRIPTOR_VALUE