Функция 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 Длительность отсрочки в минутах. Максимальное время отсрочки составляет 24 часа для обновлений ОС и 167 часов для приложений. Если вы запрашиваете отсрочку дольше максимального допустимого для события, отсрочка усекается по максимальному значению.

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: приложение не имеет возможности отложить указанное событие.

Можно также указать любой другой errno вариант, но нет никакой гарантии, что такое же поведение будет сохранено при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения или -1 для сбоя. В этом случае errno задается значение ошибки.

Требования к манифесту приложения

Манифест приложения должен включать возможности SystemEventNotifications и SoftwareUpdateDeferral.