clock_systohc-Funktion
Header: #include <applibs/rtc.h>
Synchronisiert die Echtzeituhr (Real-Time Clock, RTC) mit der aktuellen Systemzeit. Die RTC speichert nur die Zeit in UTC/GMT. Daher ist eine Konvertierung der Ortszeit nur erforderlich, wenn die lokale Zeitzone nicht GMT ist.
int clock_systohc(void);
Fehler
Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .
EACCES: Der Aufrufer verfügt nicht über die SystemTime-Funktion.
EBUSY: Das RTC-Gerät wurde verwendet und konnte nicht geöffnet werden. Der Aufrufer sollte es in regelmäßigen Abständen erneut versuchen, bis dies erfolgreich ist.
Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.
Rückgabewert
Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.
Anforderungen an das Anwendungsmanifest
Diese Funktion erfordert die SystemTime-Funktion im Anwendungsmanifest.