Partager via

SysEvent_RegisterForEventNotifications, fonction

  • Article

En-tête : #include <applibs/sysevent.h>

Inscrit l’application avec un ensemble d’événements.

Note

Il ne doit y avoir qu’un seul struct EventRegistration actif à la fois pour toutes les notifications d’événements système.

EventRegistration *SysEvent_RegisterForEventNotifications(EventLoop *el, SysEvent_Events eventBitmask SysEvent_EventsCallback callback_function, void *context);

Paramètres

  • el Boucle d’événement dans laquelle est EventRegistration inscrit.

  • eventBitmask Masque de bits qui indique les types d’événements à écouter.

  • callbackFunction Gestionnaire de fonction appelé lorsque l’état d’un événement dans eventBitmask change.

  • context Pointeur de contexte utilisateur facultatif qui est passé au rappel d’événements lorsqu’un événement se produit.

Erreurs

Retourne NULL si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : l’application n’a pas la fonctionnalité SystemEventNotifications.
  • EFAULT : le paramètre ou callback_function a la el valeur NULL.
  • EINVAL : spécifie eventBitmaskdes événements non valides.

Tout autre errno peut également être spécifié, mais le même comportement peut ne pas être conservé via les mises à jour système.

Valeur de retour

Retourne un pointeur vers un struct EventRegistration , ou NULL, auquel cas errno est défini sur la valeur d’erreur.

Remarques

Le struct EventRegistration retourné doit être conservé jusqu’à ce qu’il soit passé à SysEvent_UnregisterForEventNotifications.

Exigences du manifeste d’application

Le manifeste d’application doit inclure la fonctionnalité SystemEventNotifications.