Бөлісу құралы:

Функция SysEvent_RegisterForEventNotifications

  • Мақала

Заголовок: #include <applibs/sysevent.h>

Регистрирует приложение с набором событий.

Примечание

Для всех системных уведомлений о событиях одновременно должна быть только одна активная структуру EventRegistration .

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

Параметры

  • el Цикл событий, в котором EventRegistration зарегистрирован объект .

  • eventBitmask Битовая маска, указывающая типы событий для прослушивания.

  • callbackFunction Обработчик функции, который вызывается при изменении состояния события eventBitmask .

  • context Необязательный указатель контекста пользователя, который передается обратному вызову событий при возникновении события.

Ошибки

Возвращает значение NULL при обнаружении ошибки и задает errno значение ошибки.

  • EACCES. Приложение не имеет возможности SystemEventNotifications.
  • EFAULT: параметр el или callback_function имеет значение NULL.
  • EINVAL: указывает eventBitmaskнедопустимые события.

Можно также указать любой другой errno вариант, но такое же поведение может не сохраняться при обновлении системы.

Возвращаемое значение

Возвращает указатель на структуру EventRegistration или NULL, в этом случае errno задается значение ошибки.

Замечания

Возвращаемую структуру EventRegistration необходимо сохранить, пока она не будет передана SysEvent_UnregisterForEventNotifications.

Требования к манифесту приложения

Манифест приложения должен включать возможность SystemEventNotifications.