Freigeben über

SysEvent_DeferEvent-Funktion

  • Artikel

Header: #include <applibs/sysevent.h>

Versucht, ein Ereignis für die angegebene Dauer zu verzögern. Diese Funktion sollte nur aufgerufen werden, wenn das Ereignis status SysEvent_Status_Pending ist. Wenn das Ereignis nicht aussteht, schlägt der Aufruf fehl.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parameter

  • event Der Typ des zurück zu verschiebenden Ereignisses.

  • requested_defer_time_in_minutes Die Dauer der Verzögerung in Minuten. Die maximale Verzögerungszeit beträgt 24 Stunden für Betriebssystemupdates und 167 Stunden für Anwendungen. Wenn Sie eine Verzögerung anfordern, die länger ist als der für das Ereignis zulässige Höchstwert, wird die Verzögerung auf das Maximum abgeschnitten.

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Die Anwendung verfügt nicht über die Möglichkeit, das angegebene Ereignis zu verzögern.

Es können auch andere errno angegeben werden, aber es gibt keine Garantie, dass das gleiche Verhalten durch Systemupdates beibehalten wird.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die Funktionen SystemEventNotifications und SoftwareUpdateDeferral enthalten.