Share via

SysEvent_DeferEvent functie

  • Artikel

Header: #include <applibs/sysevent.h>

Pogingen om een gebeurtenis uit te stellen voor de opgegeven duur. Deze functie moet alleen worden aangeroepen wanneer de gebeurtenisstatus is SysEvent_Status_Pending. Als de gebeurtenis niet in behandeling is, mislukt de aanroep.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parameters

  • event Het type gebeurtenis dat u wilt uitstellen.

  • requested_defer_time_in_minutes De duur van de uitstel, in minuten. De maximale uitsteltijd is 24 uur voor updates van het besturingssysteem en 167 uur voor toepassingen. Als u uitstel aanvraagt dat langer is dan het maximum dat is toegestaan voor de gebeurtenis, wordt uitstel op het maximum afgekapt.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: de toepassing heeft niet de mogelijkheid om de opgegeven gebeurtenis uit te stellen.

Alle andere errno kunnen ook worden opgegeven, maar er is geen garantie dat hetzelfde gedrag wordt behouden via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheden SystemEventNotifications en SoftwareUpdateDeferral bevatten.