SetKey Setzen des Benutzerschlüssels

Beschreibung

Der Befehl schreibt einen Verschlüsselungsschlüssel in den Adapter. Der Schlüssel ist für die Funktion PassThruSecurityConnect erforderlich. Wird der Schlüssel mit 0xFF oder 0x00 gefüllt, funktioniert der Befehl PassThruSecurityConnect nicht. Dieser Befehl wird vom Hersteller der Software bei der Vorbereitung des Adapters für den Verkauf ausgeführt. Ein erneuter Befehl kann den neuen Schlüssel überschreiben.

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

Parameter

unsigned long DeviceID - Die beim Verbindungsaufbau mit dem Befehl PassThruOpen gespeicherte Kennung.
unsigned char* pKey - Zeiger auf den Schlüssel. Die Länge des Schlüssels beträgt 176 Byte.

Rückgabe-Fehlercodes

Definition	Beschreibung
STATUS_NOERROR	Funktion erfolgreich ausgeführt
ERR_DEVICE_NOT_CONNECTED	Keine Verbindung zum Adapter. Mögliche Ursachen: Adapter ausgeschaltet, kein Netzwerk oder IP-Adresse falsch konfiguriert.
ERR_INVALID_DEVICE_ID	Es wurde eine nicht existierende Adapter-Kennung DeviceID angegeben

Beispiel

#include "j2534_lib.hpp"

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

Ret = SetKey(DeviceID, Key);
if (Ret != STATUS_NOERROR)
{	// Fehlerbehandlung
}