SysEvent_RegisterForEventNotifications-Funktion

Header: #include <applibs/sysevent.h>

Registriert die Anwendung mit einer Reihe von Ereignissen.

Hinweis

Für alle Systemereignisbenachrichtigungen darf jeweils nur eine aktive EventRegistration-Struktur vorhanden sein.

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

Parameter

• el Die Ereignisschleife, bei der die EventRegistration registriert ist.

• eventBitmask Eine Bitmaske, die die Zu lauschenden Ereignistypen angibt.

• callbackFunction Ein Funktionshandler, der aufgerufen wird, wenn sich der Zustand eines Ereignisses in eventBitmask ändert.

• context Ein optionaler Benutzerkontextzeiger, der an den Ereignisrückruf übergeben wird, wenn ein Ereignis auftritt.

Fehler

Gibt NULL zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

• EACCES: Die Anwendung verfügt nicht über die SystemEventNotifications-Funktion.
• EFAULT: Der el Parameter oder callback_function ist NULL.
• EINVAL: Gibt eventBitmaskungültige Ereignisse an.

Es können auch andere errno angegeben werden, aber das gleiche Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.

Rückgabewert

Gibt einen Zeiger auf eine EventRegistration-Struktur oder NULL zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Bemerkungen

Die zurückgegebene EventRegistration-Struktur muss beibehalten werden, bis sie an SysEvent_UnregisterForEventNotifications übergeben wird.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die Funktion SystemEventNotifications enthalten.