1. Accueil
2. ScanDoc Development
3. Guide J2534
4. Description des fonctions PassThru

PassThruLogicalDisconnect v5.0

Fermeture du canal de communication logique

Dernière modification : 13 janvier 2026

Description

La fonction met fin à la connexion logique avec le véhicule sur le dispositif pass-thru indiqué.

En cas de réussite, la fonction renvoie STATUS_NOERROR et le canal de communication logique passe à l'état déconnecté.

long PassThruLogicalDisconnect(unsigned long ChannelID)

État déconnecté du canal

Après la déconnexion, le canal logique présente l'état suivant :

• L'identifiant du canal cesse d'être valide
• Tous les messages périodiques sont supprimés et leurs identifiants cessent d'être valides
• Tous les paramètres configurables sont réinitialisés à leurs valeurs par défaut
• Tous les messages de la file d'attente de transmission sont rejetés (sans générer TxFailed)
• Tous les messages de la file d'attente de réception sont rejetés
• Toute transmission de message active est interrompue (sans générer TxFailed)

Paramètres

ChannelID

Paramètre d'entrée. Identifiant du canal de communication logique obtenu lors de l'appel à PassThruLogicalConnect().

Codes d'erreur renvoyés

Code	Description
STATUS_NOERROR	La fonction s'est exécutée correctement
ERR_CONCURRENT_API_CALL	Une fonction de l'API J2534 a été appelée avant la fin de l'appel précédent
ERR_DEVICE_NOT_OPEN	PassThruOpen() n'a pas été appelée correctement
ERR_INVALID_CHANNEL_ID	Valeur de ChannelID non valide
ERR_DEVICE_NOT_CONNECTED	Erreur de communication avec le dispositif pass-thru. Le dispositif a été déconnecté.
ERR_NOT_SUPPORTED	La DLL ne prend pas en charge cette fonction
ERR_FAILED	Erreur non définie. Utilisez PassThruGetLastError() pour obtenir la description.

Exemples

Exemple en C/C++

#include "j2534_dll.hpp"

unsigned long logicalChannelID = ...; // ID obtenu de PassThruLogicalConnect

// Fermeture du canal logique
long ret = PassThruLogicalDisconnect(logicalChannelID);

if (ret == STATUS_NOERROR) {
    printf("Canal logique fermé\n");
} else {
    char error[256];
    PassThruGetLastError(error);
    printf("Erreur : %s\n", error);
}

Exemple en Python (ctypes)

from ctypes import *

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

logical_channel_id = c_ulong(...)  # ID obtenu de PassThruLogicalConnect

# Fermeture du canal logique
ret = j2534.PassThruLogicalDisconnect(logical_channel_id)

if ret == 0:  # STATUS_NOERROR
    print("Canal logique fermé")
else:
    error = create_string_buffer(256)
    j2534.PassThruGetLastError(error)
    print(f"Erreur : {error.value.decode()}")

Fonctions associées

• PassThruLogicalConnect() - Création du canal logique
• PassThruDisconnect() - Fermeture de la connexion physique
• PassThruClose() - Fermeture du dispositif

1. haut