RegisterCommEvent

Cette fonction membre enregistre un objet d'application pour recevoir une notification de tous les événements de connexion/déconnexion de la liaison de communication. Pour utiliser cette fonction, l'application doit créer un objet dérivé de la classe ECLCommNotify. Un pointeur vers cet objet est ensuite transmis à cette fonction d'enregistrement. Restriction d'implémentation : une application ne peut enregistrer qu'un seul objet pour la notification d'événement de communication.

Une fois qu'un objet de notification a été enregistré avec cette fonction, il sera appelé chaque fois que la liaison de communication de connexion avec l'hôte se connecte ou se déconnecte. L'objet recevra une notification pour tous les événements de communication, qu'ils soient provoqués par la fonction StartCommunication() ou explicitement par l'utilisateur. Cet événement ne doit pas être confondu avec l'événement de démarrage/arrêt de connexion qui est déclenché lorsqu'une nouvelle connexion ZIEWin démarre ou s'arrête.

Le paramètre facultatif InitEvent provoque la génération d'un événement initial lorsque l'objet est enregistré. Cela peut être utile pour synchroniser un objet événement avec l'état actuel de la liaison de communication. Si InitEvent est spécifié comme FALSE, aucun événement initial n'est généré lorsque l'objet est enregistré. La valeur par défaut de ce paramètre est TRUE.

L'application doit appeler UnregisterCommEvent() avant de détruire l'objet de notification. L'objet est automatiquement désenregistré si l'objet ECLConnection dans lequel il est enregistré est détruit.

Consultez la description de Classe ECLCommNotify pour plus d'informations.