Funzione SysEvent_DeferEventSysEvent_DeferEvent Function

Intestazione: #include <applibs/sysevent.h>Header: #include <applibs/sysevent.h>

Tenta di rinviare un evento per la durata specificata.Attempts to defer an event for the specified duration. Questa funzione deve essere chiamata solo quando lo stato dell'evento è SysEvent_Status_Pending.This function should only be called when the event status is SysEvent_Status_Pending. Se l'evento non è in sospeso, la chiamata ha esito negativo.If the event is not pending, the call fails.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

ParametriParameters

  • event Il tipo di evento da rinviare.event The type of event to defer.

  • requested_defer_time_in_minutes La durata del rinvio, in minuti.requested_defer_time_in_minutes The duration of the deferral, in minutes. Il tempo di rinvio massimo è di 24 ore per gli aggiornamenti del sistema operativo e di 167 ore per le applicazioni.The maximum deferral time is 24 hours for OS updates and 167 hours for applications. Se si richiede un tempo di rinvio maggiore del valore massimo consentito per l'evento, il rinvio viene troncato in base al valore massimo.If you request a deferral longer than the maximum allowed for the event, deferral is truncated at the maximum.

ErrorsErrors

Restituisce-1 se viene rilevato un errore e imposta sul errno valore di errore.Returns -1 if an error is encountered and sets errno to the error value.

  • EACCES: L'applicazione non dispone della funzionalità per il rinvio dell'evento specificato.EACCES: The application doesn't have the capability to defer the specified event.

errnoÈ anche possibile specificare qualsiasi altro, ma non vi è alcuna garanzia che lo stesso comportamento venga mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified, but there's no guarantee that the same behavior will be retained through system updates.

Valore restituitoReturn value

Restituisce 0 per l'esito positivo o-1 per l'esito negativo, nel qual caso errno viene impostato sul valore di errore.Returns 0 for success, or -1 for failure, in which case errno is set to the error value.

Requisiti del manifesto dell'applicazioneApplication manifest requirements

Il manifesto dell'applicazione deve includere le funzionalità SystemEventNotifications e SoftwareUpdateDeferral.The application manifest must include the SystemEventNotifications and SoftwareUpdateDeferral capabilities.