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
當事件發生時,傳送給事件回撥的選用使用者內容指標。
錯誤
如果發生錯誤,並設定為 errno
錯誤值,則傳回 Null。
- EACCES:應用程式沒有 SystemEventNotifications 功能。
- EFAULT:此
el
或callback_function
參數為 Null。 - EINVAL:指定
eventBitmask
無效事件。
您也可以指定任何其他 errno
行為,但相同的行為可能無法透過系統更新來保留。
傳回值
傳回指標至 EventRegistration 結構或 Null,在這種情況下 errno
會設定為錯誤值。
言論
傳回 的 EventRegistration 結構必須先保留,直到傳 送到SysEvent_UnregisterForEventNotifications。
應用程式資訊清單需求
應用程式 資訊清單 必須包含 SystemEventNotifications 功能。