Sdílet prostřednictvím

funkce SysEvent_DeferEvent

  • Článek

Hlavička: #include <applibs/sysevent.h>

Pokusí se odložit událost o zadanou dobu trvání. Tato funkce by se měla volat pouze v případě, že je stav události SysEvent_Status_Pending. Pokud událost nevyřízla, volání selže.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parametry

  • event Typ události, která se má odložit.

  • requested_defer_time_in_minutes Doba trvání odkladu v minutách. Maximální doba odkladu je 24 hodin u aktualizací operačního systému a 167 hodin pro aplikace. Pokud požádáte o odložení delší, než je povolené maximum události, zkrátí se maximálně.

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Aplikace nemá možnost odložit zadanou událost.

Je možné zadat i jakékoli jiné errno , ale není zaručeno, že se stejné chování zachová prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí hodnotu 0 pro úspěch nebo -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkce SystemEventNotifications a SoftwareUpdateDeferral.