Share via


SysEvent_DeferEvent İşlevi

Üst bilgi: #include <applibs/sysevent.h>

Belirtilen süre boyunca bir olayı ertelemeye çalışır. Bu işlev yalnızca olay durumu SysEvent_Status_Pending olduğunda çağrılmalıdır. Olay beklemede değilse, çağrı başarısız olur.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parametre

  • event Ertelenecek olayın türü.

  • requested_defer_time_in_minutes Erteleme süresi (dakika cinsinden). En uzun erteleme süresi, işletim sistemi güncelleştirmeleri için 24 saat ve uygulamalar için 167 saattir. Olay için izin verilen üst sınırdan daha uzun bir erteleme isteğinde bulunursanız, erteleme maksimumda kesilir.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulamanın belirtilen olayı erteleme özelliği yoktur.

Diğer errno tüm davranışlar da belirtilebilir, ancak sistem güncelleştirmeleri aracılığıyla aynı davranışın korunacağının garantisi yoktur.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi SystemEventNotifications ve SoftwareUpdateDeferral özelliklerini içermelidir.