SetKey Ustawienie klucza użytkownika

Opis

Polecenie zapisuje klucz szyfrowania w adapterze. Klucz jest niezbędny do działania funkcji PassThruSecurityConnect. Jeśli klucz zostanie wypełniony wartościami 0xFF lub 0x00, polecenie PassThruSecurityConnect nie będzie działać. Polecenie to jest wykonywane przez producenta oprogramowania podczas przygotowania adaptera do sprzedaży. Powtórne wykonanie polecenia może nadpisać nowy klucz.

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

Parametry

unsigned long DeviceID - Identyfikator zapisany podczas nawiązywania połączenia poleceniem PassThruOpen.
unsigned char* pKey - Wskaźnik na klucz. Długość klucza wynosi 176 bajtów.

Zwracane kody błędów

Definicja	Opis
STATUS_NOERROR	Funkcja wykonana pomyślnie
ERR_DEVICE_NOT_CONNECTED	Brak połączenia z adapterem. Możliwe przyczyny: adapter jest wyłączony, brak sieci lub nieprawidłowo ustawiony adres IP.
ERR_INVALID_DEVICE_ID	Podano nieistniejący identyfikator adaptera DeviceID

Przykład

#include "j2534_lib.hpp"

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

Ret = SetKey(DeviceID, Key);
if (Ret != STATUS_NOERROR)
{	// Obsługa błędu
}