Fonction ClearCommError (winbase.h)

Récupère des informations sur une erreur de communication et signale la status actuelle d’un appareil de communication. La fonction est appelée lorsqu’une erreur de communication se produit, et elle efface l’indicateur d’erreur de l’appareil pour activer des opérations d’entrée et de sortie (E/S) supplémentaires.

Syntaxe

BOOL ClearCommError(
  [in]            HANDLE    hFile,
  [out, optional] LPDWORD   lpErrors,
  [out, optional] LPCOMSTAT lpStat
);

Paramètres

[in] hFile

Handle de l’appareil de communication. La fonction CreateFile retourne ce handle.

[out, optional] lpErrors

Pointeur vers une variable qui reçoit un masque indiquant le type d’erreur. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Les valeurs suivantes ne sont pas prises en charge :

[out, optional] lpStat

Pointeur vers une structure COMSTAT dans laquelle les informations status de l’appareil sont retournées. Si ce paramètre a la valeur NULL, aucune information status n’est retournée.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si un port de communication a été configuré avec une valeur TRUE pour le membre fAbortOnError de la structure DCB d’installation, le logiciel de communication met fin à toutes les opérations de lecture et d’écriture sur le port de communication en cas d’erreur de communication. Aucune nouvelle opération de lecture ou d’écriture ne sera acceptée tant que l’application n’aura pas reconnu l’erreur de communication en appelant la fonction ClearCommError .

La fonction ClearCommError remplit la mémoire tampon status pointée par le paramètre lpStat avec la status actuelle de l’appareil de communication spécifié par le paramètre hFile.

Configuration requise

Voir aussi

COMSTAT

ClearCommBreak

Fonctions de communication

Ressources de communication

CreateFile

DCB