PassThruStopMsgFilter v4.04 v5.0

Nachrichtenfilter entfernen

Letzte Änderung: 11. Januar 2026

Beschreibung

Diese Funktion entfernt einen der zuvor eingerichteten Filter.

long PassThruStopMsgFilter(unsigned long ChannelID, unsigned long FilterID)

Parameter

unsigned long ChannelID - Die beim Verbindungsaufbau mit dem Befehl PassThruConnect gespeicherte Kanal-ID.
unsigned long FilterID - Die ID des zu entfernenden Filters, der zuvor über PassThruStartMsgFilter erstellt wurde.

Rückgabe-Fehlercodes

Code	Beschreibung	Mögliche Ursachen und Lösungen
STATUS_NOERROR	Funktion erfolgreich ausgeführt	—
ERR_DEVICE_NOT_CONNECTED	Keine Verbindung zum Adapter	Adapter ist ausgeschaltet oder außer Reichweite Lösung: Prüfen Sie die Stromversorgung des Adapters und die Netzwerkverbindung
ERR_INVALID_DEVICE_ID	Ungültige Geräte-ID	DeviceID wurde nicht über PassThruOpen bezogen oder das Gerät ist bereits geschlossen Lösung: Stellen Sie sicher, dass PassThruOpen erfolgreich ausgeführt wurde
ERR_INVALID_CHANNEL_ID	Ungültige Kanal-ID	ChannelID wurde nicht über PassThruConnect bezogen oder der Kanal ist bereits geschlossen Lösung: Stellen Sie sicher, dass PassThruConnect erfolgreich ausgeführt wurde
ERR_INVALID_FILTER_ID	Ungültige Filter-ID	FilterID wurde nicht über PassThruStartMsgFilter bezogen oder der Filter ist bereits entfernt Lösung: Verwenden Sie die von PassThruStartMsgFilter zurückgegebene FilterID
ERR_FAILED	Nicht näher bestimmter Fehler	Interner Fehler der Bibliothek oder des Adapters Lösung: Rufen Sie `PassThruGetLastError()` auf, um eine Beschreibung zu erhalten

Beispiele

Beispiel in C/C++

#include "j2534_lib.hpp"

unsigned long ChannelID; // Kanal-ID
unsigned long FilterID;  // Filter-ID, von PassThruStartMsgFilter erhalten
long Ret;

Ret = PassThruStopMsgFilter(ChannelID, FilterID);
if (Ret != STATUS_NOERROR)
{
    // Fehlerbehandlung
}

Beispiel in Kotlin (Android)

// channelID und filterID wurden zuvor bezogen
val result = j2534.ptStopMsgFilter(channelID, filterID)
if (result.status == STATUS_NOERROR) {
    // Filter erfolgreich entfernt
    Log.i("J2534", "Filter $filterID entfernt.")
} else {
    // Fehlerbehandlung
    Log.e("J2534", "Fehler beim Entfernen des Filters: ${result.status}")
}

Beispiel in Python

from ctypes import *

# channelID und filterID wurden zuvor bezogen
ret = j2534.PassThruStopMsgFilter(channel_id, filter_id)
if ret == 0:  # STATUS_NOERROR
    print(f"Filter {filter_id} entfernt")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Fehler: {error.value.decode()}")

Beispiel in C#

// channelID und filterID wurden zuvor bezogen
int ret = J2534.PassThruStopMsgFilter(channelId, filterId);
if (ret == 0) // STATUS_NOERROR
{
    Console.WriteLine($"Filter {filterId} entfernt");
}
else
{
    var error = new StringBuilder(256);
    J2534.PassThruGetLastError(error);
    Console.WriteLine($"Fehler: {error}");
}