SetKey Installation de la clé utilisateur

Description

La commande écrit la clé de chiffrement dans l'adaptateur. La clé est nécessaire au fonctionnement de la fonction PassThruSecurityConnect. Si la clé est remplie de valeurs 0xFF ou 0x00, la commande PassThruSecurityConnect ne fonctionnera pas. Cette commande est exécutée par le fabricant du logiciel lors de la préparation de l'adaptateur à la vente. Une exécution répétée de la commande peut écraser la nouvelle clé.

long SetKey(unsigned long DeviceID, unsigned char* pKey )

Paramètres

unsigned long DeviceID - Identifiant enregistré lors de l'établissement de la connexion avec la commande PassThruOpen.
unsigned char* pKey - Pointeur vers la clé. La longueur de la clé est de 176 bytes.

Codes d'erreur renvoyés

Définition	Description
STATUS_NOERROR	La fonction s'est exécutée correctement
ERR_DEVICE_NOT_CONNECTED	Pas de connexion avec l'adaptateur. Causes possibles : l'adaptateur est éteint, il n'y a pas de réseau ou l'adresse IP est mal configurée.
ERR_INVALID_DEVICE_ID	Un identifiant d'adaptateur DeviceID inexistant a été indiqué

Exemple

#include "j2534_lib.hpp"

unsigned long DeviceID;
unsigned long Ret;
unsigned char Key[176];

Ret = SetKey(DeviceID, Key);
if (Ret != STATUS_NOERROR)
{	// Gestion de l'erreur
}