Partilhar via

Função SysEvent_DeferEvent

  • Artigo

Cabeçalho: #include <applibs/sysevent.h>

Tenta diferir um evento para a duração especificada. Esta função só deve ser chamada quando o estado do evento for SysEvent_Status_Pending. Se o evento não estiver pendente, a chamada falha.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parâmetros

  • event O tipo de evento a diferir.

  • requested_defer_time_in_minutes A duração do diferimento, em minutos. O tempo máximo de diferimento é de 24 horas para as atualizações do SO e 167 horas para as aplicações. Se pedir um adiamento superior ao máximo permitido para o evento, o diferimento será truncado no máximo.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: a aplicação não tem a capacidade de diferir o evento especificado.

Qualquer outro errno também pode ser especificado, mas não há garantias de que o mesmo comportamento será mantido através das atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir as capacidades SystemEventNotifications e SoftwareUpdateDeferral.