Fonction BluetoothSendAuthenticationResponse (bluetoothapis.h)

Article
02/23/2024

La fonction BluetoothSendAuthenticationResponse est appelée lorsqu’une demande d’authentification pour envoyer la réponse de clé d’accès est reçue.

Note Lors du développement pour Windows Vista SP2 et Windows 7, l’utilisation de BluetoothSendAuthenticationResponseEx est recommandée.

Syntaxe

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

Paramètres

hRadio

Handle facultatif pour le handle radio local, ou NULL. Si la valeur est NULL, la fonction tente d’envoyer une réponse d’authentification sur toutes les radios locales.

pbtdi

Pointeur vers une structure BLUETOOTH_DEVICE_INFO décrivant l’appareil Bluetooth en cours d’authentification. Il peut s’agir de la même structure passée à la fonction de rappel.

pszPasskey

Pointeur vers une chaîne unicode à terminaison zéro de la réponse de clé d’accès à renvoyer à l’appareil d’authentification. Le paramètre pszPasskey ne peut pas être supérieur à BLUETOOTH_MAX_PASSKEY_SIZE, à l’exception de NULL. Si la traduction vers ANSI est effectuée, le paramètre pszPasskey ne peut pas être supérieur à 16 octets, à l’exception de NULL.

Valeur retournée

Retourne ERROR_SUCCESS lorsque l’appareil accepte la réponse de clé d’accès ; l’appareil est authentifié. Toute autre valeur de retour indique un échec. Le tableau suivant décrit les erreurs courantes :

Code de retour	Description
ERROR_CANCELLED	L’appareil Bluetooth a refusé la réponse de clé d’accès. Cette erreur est également retournée si un problème de communication existe avec la radio locale.
E_FAIL	L’appareil a retourné un code d’échec lors de l’authentification.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)
Bibliothèque	Bthprops.lib
DLL	bthprops.cpl