Funzione SysEvent_RegisterForEventNotificationsSysEvent_RegisterForEventNotifications Function

Intestazione: #include <applibs/sysevent.h>Header: #include <applibs/sysevent.h>

Registra l'applicazione con un set di eventi.Registers the application with a set of events.

Nota

Per tutte le notifiche degli eventi di sistema deve essere presente un solo struct EventRegistration attivo alla volta.There must only be one active EventRegistration struct at a time for all system event notifications.

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

ParametriParameters

  • el Il ciclo di eventi in cui è registrato EventRegistration.el The event loop to which the EventRegistration is registered.

  • eventBitmask Maschera di bit che indica i tipi di evento da ascoltare.eventBitmask A bitmask that indicates the event types to listen to.

  • callbackFunction Un gestore di funzione chiamato quando cambia lo stato di un evento in eventBitmask.callbackFunction A function handler that is called when the state of an event in eventBitmask changes.

  • context Puntatore di contesto utente facoltativo che viene passato al callback degli eventi quando si verifica un evento.context An optional user context pointer that is passed to the events callback when an event occurs.

ErrorsErrors

Restituisce NULL se viene rilevato un errore e imposta sul errno valore di errore.Returns NULL if an error is encountered and sets errno to the error value.

  • EACCES: L'applicazione non dispone della funzionalità SystemEventNotifications.EACCES: The application doesn't have the SystemEventNotifications capability.
  • EFAULT: Il parametro el o callback_function è NULL.EFAULT: The el or callback_function parameter is NULL.
  • EINVAL: eventBitmask specifica gli eventi non validi.EINVAL: The eventBitmaskspecifies invalid events.

errnoÈ possibile specificare anche qualsiasi altro, ma lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified, but the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce un puntatore a uno struct EventRegistration o null, nel qual caso errno viene impostato sul valore di errore.Returns a pointer to an EventRegistration struct, or NULL, in which case errno is set to the error value.

OsservazioniRemarks

Lo struct EventRegistration restituito deve essere mantenuto fino a quando non viene passato a SysEvent_UnregisterForEventNotifications.The EventRegistration struct that is returned needs to be retained until it is passed to SysEvent_UnregisterForEventNotifications.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Il manifesto dell'applicazione deve includere la funzionalità SystemEventNotifications.The application manifest must include the SystemEventNotifications capability.