Compartilhar via

Função BluetoothGATTBeginReliableWrite (bluetoothleapis.h)

  • Artigo

A função BluetoothGATTBeginReliableWrite especifica que as gravações confiáveis estão prestes a começar.

Sintaxe

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

Parâmetros

[in] hDevice

Manipule para o serviço.

[out] ReliableWriteContext

Endereço de uma estrutura BTH_LE_GATT_RELIABLE_WRITE_CONTEXT que contém o contexto que descreve a operação de gravação confiável.

[in] Flags

Sinalizadores para modificar o comportamento de BluetoothGATTBeginReliableWrite:

Sinalizador Descrição
BLUETOOTH_GATT_FLAG_NONE O cliente não tem requisitos de GATT específicos (padrão).

Retornar valor

A função BluetoothGATTBeginReliableWrite retorna os seguintes valores:

Código de retorno Descrição
S_OK
 A operação foi concluída com sucesso.
ERROR_ACCESS_DENIED
 Retornado se um serviço pai e um identificador de serviço forem fornecidos e a hierarquia de serviço não for acumulada para o identificador de serviço pai fornecido.
ERROR_INVALID_FUNCTION
 Uma operação de gravação confiável já está em andamento.

Comentários

A função BluetoothGATTBeginReliableWrite notifica a pilha Bluetooth de que os procedimentos que devem ser chamados após o retorno da função são operações de gravação confiáveis. Todas as operações que não dão suporte a gravações confiáveis retornarão um erro ERROR_INVALID_FUNCTION . Somente as seguintes funções dão suporte a operações de gravação confiáveis:

Exemplos


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

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte em Windows 8 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho bluetoothleapis.h
Biblioteca BluetoothAPIs.lib
DLL BluetoothAPIs.dll