Partage via

SysEvent_DeferEvent, fonction

  • Article

En-tête : #include <applibs/sysevent.h>

Tente de différer un événement pendant la durée spécifiée. Cette fonction ne doit être appelée que lorsque l’événement status est SysEvent_Status_Pending. Si l’événement n’est pas en attente, l’appel échoue.

int SysEvent_DeferEvent(SysEvent_Events event, uint32_t requested_defer_time_in_minutes);

Paramètres

  • event Type d’événement à différer.

  • requested_defer_time_in_minutes Durée du report, en minutes. Le délai de report maximal est de 24 heures pour les mises à jour du système d’exploitation et de 167 heures pour les applications. Si vous demandez un report plus long que le maximum autorisé pour l’événement, le report est tronqué au maximum.

Erreurs

Retourne -1 si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EACCES : l’application ne peut pas différer l’événement spécifié.

Tout autre errno peut également être spécifié, mais il n’existe aucune garantie que le même comportement sera conservé via les mises à jour système.

Valeur de retour

Retourne 0 pour la réussite, ou -1 en cas d’échec, auquel cas errno est défini sur la valeur d’erreur.

Exigences du manifeste d’application

Le manifeste de l’application doit inclure les fonctionnalités SystemEventNotifications et SoftwareUpdateDeferral.