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 기능이 포함되어야 합니다.