Função BluetoothSendAuthenticationResponse (bluetoothapis.h)

Artigo
02/26/2024

A função BluetoothSendAuthenticationResponse é chamada quando uma solicitação de autenticação para enviar a resposta da chave de passagem é recebida.

Nota Ao desenvolver para Windows Vista SP2 e Windows 7, é recomendável usar BluetoothSendAuthenticationResponseEx .

Sintaxe

DWORD BluetoothSendAuthenticationResponse(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  LPCWSTR                     pszPasskey
);

Parâmetros

hRadio

Identificador opcional para o identificador de rádio local ou NULL. Se NULL, a função tentará enviar uma resposta de autenticação em todos os rádios locais.

pbtdi

Ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO que descreve o dispositivo Bluetooth que está sendo autenticado. Essa pode ser a mesma estrutura passada para a função de retorno de chamada.

pszPasskey

Ponteiro para uma cadeia de caracteres terminada em zero UNICODE da resposta da chave de passagem a ser enviada de volta para o dispositivo de autenticação. o parâmetro pszPasskey não pode ser maior que BLUETOOTH_MAX_PASSKEY_SIZE, excluindo NULL. Se a conversão para ANSI for executada, o parâmetro pszPasskey não poderá ser maior que 16 bytes, excluindo NULL.

Retornar valor

Retorna ERROR_SUCCESS quando o dispositivo aceita a resposta da chave de acesso; o dispositivo é autenticado. Qualquer outro valor retornado indica falha. A tabela a seguir descreve erros comuns:

Código de retorno	Descrição
ERROR_CANCELLED	O dispositivo Bluetooth negou a resposta da chave de acesso. Esse erro também será retornado se houver um problema de comunicação com o rádio local.
E_FAIL	O dispositivo retornou um código de falha durante a autenticação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h)
Biblioteca	Bthprops.lib
DLL	bthprops.cpl