Share via


clock_systohc, fonction

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

Synchronise l’horloge en temps réel (RTC) avec l’heure système actuelle. Le RTC stocke uniquement l’heure UTC/GMT. Par conséquent, la conversion à partir de l’heure locale n’est nécessaire que si le fuseau horaire local n’est pas GMT.

int clock_systohc(void);

Erreurs

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

  • EACCES : l’appelant n’a pas la fonctionnalité SystemTime.

  • EBUSY : l’appareil RTC était en cours d’utilisation et n’a pas pu être ouvert. L’appelant doit réessayer régulièrement jusqu’à ce qu’il réussisse.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des 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

Cette fonction nécessite la fonctionnalité SystemTime dans le manifeste de l’application.

Concepts et exemples