Applibs sysevent.h

Header: #include <applibs/sysevent.h>

The Applibs sysevent header contains functions and types for system event notifications. Applications can register for and unregister from update notifications. Apps can use these notifications to put themselves in a safe state before application shutdown, or can attempt to defer these events.

Application manifest requirements

You can only call these functions if your application has the SystemEventNotifications capability configured in the application manifest.

To call the SysEvent_DeferEvent or SysEvent_ResumeEvent functions, you must also configure the SoftwareUpdateDeferral capability in the application manifest.

Concepts and samples

Functions

Function Description
SysEvent_DeferEvent Attempts to defer an event for the specified duration.
SysEvent_EventsCallback This callback function is called when the status of a registered system event changes.
SysEvent_Info_GetUpdateData Retrieves application or OS update information.
SysEvent_RegisterForEventNotifications Registers the application with a set of events.
SysEvent_ResumeEvent Attempts to resume an event if it is deferred.
SysEvent_UnregisterForEventNotifications Unregisters from the system notifications that were registered by SysEvent_RegisterForEventNotifications.

Structs

Struct Description
SysEvent_Info An opaque struct that contains information about a system event.
SysEvent_Info_UpdateData A struct that contains information about update events.

Enums

Enum Description
SysEvent_Events Flags for system event types.
SysEvent_Status The status of a system event.
SysEvent_UpdateType The type of update to apply.