Funzione BluetoothSendAuthenticationResponse (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothSendAuthenticationResponse viene chiamata quando viene ricevuta una richiesta di autenticazione per inviare la risposta passkey.

Nota Quando si sviluppa per Windows Vista SP2 e Windows 7, è consigliabile usare BluetoothSendAuthenticationResponseEx .

Sintassi

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

Parametri

hRadio

Handle facoltativo per l'handle di opzione locale o NULL. Se NULL, la funzione tenta di inviare una risposta di autenticazione su tutte le radio locali.

pbtdi

Puntatore a una struttura BLUETOOTH_DEVICE_INFO che descrive il dispositivo Bluetooth autenticato. Può trattarsi della stessa struttura passata alla funzione di callback.

pszPasskey

Puntatore a una stringa unicode con terminazione zero della risposta passkey da inviare al dispositivo di autenticazione. Il parametro pszPasskey non può essere maggiore di BLUETOOTH_MAX_PASSKEY_SIZE, escluso NULL. Se viene eseguita la conversione in ANSI, il parametro pszPasskey non può essere maggiore di 16 byte, escluso NULL.

Valore restituito

Restituisce ERROR_SUCCESS quando il dispositivo accetta la risposta passkey; il dispositivo viene autenticato. Qualsiasi altro valore restituito indica un errore. La tabella seguente descrive gli errori comuni:

Codice restituito	Descrizione
ERROR_CANCELLED	Il dispositivo Bluetooth ha negato la risposta passkey. Questo errore viene restituito anche se esiste un problema di comunicazione con la radio locale.
E_FAIL	Il dispositivo ha restituito un codice di errore durante l'autenticazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (include Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl