Udostępnij za pośrednictwem

Funkcja SysEvent_RegisterForEventNotifications

  • Artykuł

Nagłówek: #include <applibs/sysevent.h>

Rejestruje aplikację z zestawem zdarzeń.

Uwaga

Dla wszystkich powiadomień o zdarzeniach systemowych musi być jednocześnie tylko jedna aktywna struktura EventRegistration .

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

Parametry

  • el Pętla zdarzenia, do której jest zarejestrowana EventRegistration .

  • eventBitmask Maska bitowa wskazująca typy zdarzeń do odsłuchiwania.

  • callbackFunction Program obsługi funkcji, który jest wywoływany, gdy stan zdarzenia w zmianie eventBitmask .

  • context Opcjonalny wskaźnik kontekstowy użytkownika przekazywany do wywołania zwrotnego zdarzeń w przypadku wystąpienia zdarzenia.

Błędy

Zwraca wartość NULL, jeśli wystąpi błąd i ustawia errno wartość błędu.

  • EACCES: Aplikacja nie ma funkcji SystemEventNotifications.
  • EFAULT: parametr el lub callback_function ma wartość NULL.
  • EINVAL: eventBitmaskOkreśla nieprawidłowe zdarzenia.

Mogą również zostać określone inne errno , ale to samo zachowanie może nie być zachowywane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wskaźnik do struktury EventRegistration (NULL), w którym to przypadku errno jest ustawiona wartość błędu.

Uwagi

Zwracana struktura EventRegistration musi zostać zachowana, dopóki nie zostanie przekazana do SysEvent_UnregisterForEventNotifications.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję SystemEventNotifications.