Share via

SysEvent_RegisterForEventNotifications İşlevi

  • Makale

Üst bilgi: #include <applibs/sysevent.h>

Uygulamayı bir dizi olayla kaydeder.

Not

Tüm sistem olayı bildirimleri için aynı anda yalnızca bir etkin EventRegistration yapısı olmalıdır.

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

Parametre

  • el öğesinin kaydedildiği EventRegistration olay döngüsü.

  • eventBitmask Dinlenecek olay türlerini gösteren bir bit maskesi.

  • callbackFunction Bir olayın durumu değiştiğinde eventBitmask çağrılan işlev işleyicisi.

  • context Bir olay gerçekleştiğinde olaylar geri çağırmasına geçirilen isteğe bağlı bir kullanıcı bağlamı işaretçisi.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno NULL döndürür.

  • EACCES: Uygulamanın SystemEventNotifications özelliği yoktur.
  • EFAULT: el veya callback_function parametresi NULL'dir.
  • EINVAL: geçersiz eventBitmaskolayları belirtir.

Diğer errno tüm davranışlar da belirtilebilir, ancak sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

EventRegistration yapısına veya NULL değerine yönelik bir işaretçi döndürür ve bu durumda errno hata değerine ayarlanır.

Açıklamalar

Döndürülen EventRegistration yapısı , SysEvent_UnregisterForEventNotifications geçirilene kadar korunmalıdır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi SystemEventNotifications özelliğini içermelidir.