Função SysEvent_RegisterForEventNotifications
Cabeçalho: #include <applibs/sysevent.h>
Registra o aplicativo com um conjunto de eventos.
Nota
Deve haver apenas um struct eventRegistration ativo por vez para todas as notificações de evento do sistema.
EventRegistration *SysEvent_RegisterForEventNotifications(EventLoop *el, SysEvent_Events eventBitmask SysEvent_EventsCallback callback_function, void *context);
Parâmetros
el
O loop de eventos no qual oEventRegistration
está registrado.eventBitmask
Uma máscara de bit que indica os tipos de evento a serem ouvidos.callbackFunction
Um manipulador de funções chamado quando o estado de um evento éeventBitmask
alterado.context
Um ponteiro de contexto de usuário opcional que é passado para o retorno de chamada de eventos quando ocorre um evento.
Erros
Retorna NULL se um erro for encontrado e definir errno
como o valor do erro.
- EACCES: o aplicativo não tem a funcionalidade SystemEventNotifications.
- EFAULT: o
el
parâmetro oucallback_function
é NULL. - EINVAL: o
eventBitmask
especifica eventos inválidos.
Qualquer outra errno
também pode ser especificada, mas o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.
Valor retornado
Retorna um ponteiro para um struct eventRegistration ou NULL, nesse caso errno
é definido como o valor do erro.
Observações
O struct EventRegistration que é retornado precisa ser mantido até que seja passado para SysEvent_UnregisterForEventNotifications.
Requisitos de manifesto do aplicativo
O manifesto do aplicativo deve incluir o recurso SystemEventNotifications.