SysEvent_RegisterForEventNotifications functie

Header: #include <applibs/sysevent.h>

Registreert de toepassing met een set gebeurtenissen.

Opmerking

Er mag slechts één actieve EventRegistration-struct tegelijk zijn voor alle systeem gebeurtenismeldingen.

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

Parameters

• el De gebeurtenislus waarbij de EventRegistration is geregistreerd.

• eventBitmask Een bitmasker dat de gebeurtenistypen aangeeft waarnaar moet worden geluisterd.

• callbackFunction Een functie-handler die wordt aangeroepen wanneer de status van een gebeurtenis in eventBitmask verandert.

• context Een optionele gebruikerscontextaanwijzer die wordt doorgegeven aan de callback van gebeurtenissen wanneer een gebeurtenis plaatsvindt.

Fouten

Retourneert NULL als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

• EACCES: De toepassing beschikt niet over de mogelijkheid SystemEventNotifications.
• EFAULT: de el parameter of callback_function is NULL.
• EINVAL: de eventBitmaskgeeft ongeldige gebeurtenissen op.

errno Andere kunnen ook worden opgegeven, maar hetzelfde gedrag wordt mogelijk niet behouden via systeemupdates.

Retourwaarde

Retourneert een aanwijzer naar een EventRegistration-struct of NULL, in welk geval errno is ingesteld op de foutwaarde.

Opmerkingen

De eventRegistration-struct die wordt geretourneerd, moet worden bewaard totdat deze wordt doorgegeven aan SysEvent_UnregisterForEventNotifications.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid SystemEventNotifications bevatten.