SysEvent_DeferEvent 函数

标头: #include <applibs/sysevent.h>

尝试在指定的持续时间内延迟事件。 仅当事件状态为 SysEvent_Status_Pending时,才应调用此函数。 如果事件未挂起,则调用失败。

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

参数

  • event 要延迟的事件的类型。

  • requested_defer_time_in_minutes 延迟的持续时间(以分钟为单位)。 OS 更新的最大延迟时间为 24 小时,应用程序的最大延迟时间为 167 小时。 如果请求的延迟时间长于事件允许的最大值,则延迟将截断为最大值。

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EACCES:应用程序无法延迟指定的事件。

也可以指定任何其他 errno 行为,但不能保证通过系统更新保留相同的行为。

返回值

如果成功,则返回 0,如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

应用程序清单要求

应用程序清单必须包含 SystemEventNotifications 和 SoftwareUpdateDeferral 功能。