Share via

Função SysEvent_RegisterForEventNotifications

  • Artigo

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 o EventRegistration 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 ou callback_function é NULL.
  • EINVAL: o eventBitmaskespecifica 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.