Compartilhar via


Função SysEvent_DeferEvent

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

Tenta adiar um evento pela duração especificada. Essa função só deve ser chamada quando o evento status estiver SysEvent_Status_Pending. Se o evento não estiver pendente, a chamada falhará.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Parâmetros

  • event O tipo de evento a ser adiado.

  • requested_defer_time_in_minutes A duração do adiamento, em minutos. O tempo máximo de adiamento é de 24 horas para atualizações do sistema operacional e 167 horas para aplicativos. Se você solicitar um adiamento maior que o máximo permitido para o evento, o adiamento será truncado no máximo.

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EACCES: o aplicativo não tem a capacidade de adiar o evento especificado.

Qualquer outra errno também pode ser especificada, mas não há garantia de que o mesmo comportamento será mantido por meio de atualizações do sistema.

Valor retornado

Retorna 0 para êxito ou -1 para falha, nesse caso errno é definido como o valor do erro.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir os recursos SystemEventNotifications e SoftwareUpdateDeferral.