Condividi tramite


Funzione SysEvent_DeferEvent

Intestazione: #include <applicazioni/sysevent.h>

Tenta di rinviare un evento per la durata specificata. Questa funzione deve essere chiamata solo quando lo stato dell'evento è SysEvent_Status_Pending. Se l'evento non è in sospeso, la chiamata non riesce.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parametri

  • event Tipo di evento da rinviare.

  • requested_defer_time_in_minutes Durata del rinvio, in minuti. Il tempo di rinvio massimo è di 24 ore per gli aggiornamenti del sistema operativo e di 167 ore per le applicazioni. Se si richiede un rinvio più lungo del massimo consentito per l'evento, il rinvio viene troncato al massimo.

Errori

Restituisce -1 se si verifica un errore e imposta errno il valore di errore.

  • EACCES: l'applicazione non dispone della capacità di rinviare l'evento specificato.

È anche possibile specificare qualsiasi altro errno comportamento, ma non è garantito che lo stesso comportamento venga mantenuto tramite gli aggiornamenti di sistema.

Valore restituito

Restituisce 0 per operazione riuscita o -1 per errore, nel qual caso errno è impostato sul valore di errore.

Requisiti del manifesto dell'applicazione

Il manifesto dell'applicazione deve includere le funzionalità SystemEventNotifications e SoftwareUpdateDeferral.