Partager via


Fonction BluetoothSendAuthenticationResponse (bluetoothapis.h)

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

Voir aussi

BLUETOOTH_DEVICE_INFO

BluetoothAuthenticateDevice

BluetoothAuthenticateMultipleDevices

BluetoothEnableDiscovery

BluetoothEnableIncomingConnections

BluetoothIsConnectable

BluetoothIsDiscoverable

BluetoothRegisterForAuthentication

BluetoothSendAuthenticationResponseEx

BluetoothUnregisterAuthentication