PassThruLogicalDisconnect v5.0

Schließen eines logischen Kommunikationskanals

Letzte Änderung: 13. Januar 2026

Beschreibung

Die Funktion beendet eine logische Verbindung zum Fahrzeug auf dem angegebenen Pass-Thru-Gerät.

Bei erfolgreicher Ausführung liefert die Funktion STATUS_NOERROR zurück, und der logische Kommunikationskanal geht in den getrennten Zustand über.

long PassThruLogicalDisconnect(unsigned long ChannelID)

Getrennter Zustand des Kanals

Nach dem Trennen weist der logische Kanal folgenden Zustand auf:

Die Kanal-ID wird ungültig
Alle periodischen Nachrichten werden entfernt, ihre IDs werden ungültig
Alle konfigurierbaren Parameter werden auf ihre Standardwerte zurückgesetzt
Alle Nachrichten in der Sendewarteschlange werden verworfen (ohne TxFailed zu erzeugen)
Alle Nachrichten in der Empfangswarteschlange werden verworfen
Jede laufende Nachrichtenübertragung wird abgebrochen (ohne TxFailed zu erzeugen)

Parameter

ChannelID

Eingabeparameter. Die ID des logischen Kommunikationskanals, die beim Aufruf von PassThruLogicalConnect() zurückgegeben wurde.

Rückgabe-Fehlercodes

Code	Beschreibung
STATUS_NOERROR	Funktion erfolgreich ausgeführt
ERR_CONCURRENT_API_CALL	Eine J2534-API-Funktion wurde aufgerufen, bevor der vorherige Aufruf abgeschlossen war
ERR_DEVICE_NOT_OPEN	`PassThruOpen()` wurde nicht erfolgreich aufgerufen
ERR_INVALID_CHANNEL_ID	Ungültiger Wert für `ChannelID`
ERR_DEVICE_NOT_CONNECTED	Kommunikationsfehler mit dem Pass-Thru-Gerät. Das Gerät wurde getrennt.
ERR_NOT_SUPPORTED	Die DLL unterstützt diese Funktion nicht
ERR_FAILED	Nicht näher bestimmter Fehler. Verwenden Sie `PassThruGetLastError()`, um eine Beschreibung zu erhalten.

Beispiele

Beispiel in C/C++

#include "j2534_dll.hpp"

unsigned long logicalChannelID = ...; // Aus PassThruLogicalConnect erhaltene ID

// Logischen Kanal schließen
long ret = PassThruLogicalDisconnect(logicalChannelID);

if (ret == STATUS_NOERROR) {
    printf("Logischer Kanal geschlossen\n");
} else {
    char error[256];
    PassThruGetLastError(error);
    printf("Fehler: %s\n", error);
}

Beispiel in Python (ctypes)

from ctypes import *

j2534 = cdll.LoadLibrary("libj2534_v05_00.dylib")

logical_channel_id = c_ulong(...)  # Aus PassThruLogicalConnect erhaltene ID

# Logischen Kanal schließen
ret = j2534.PassThruLogicalDisconnect(logical_channel_id)

if ret == 0:  # STATUS_NOERROR
    print("Logischer Kanal geschlossen")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Fehler: {error.value.decode()}")