TMS International BV |
SetRTCTime
BOOLEAN APIENTRY SetRtcTime(
IN HANDLE Handle,
IN SYSTEMTIME *InTime )
Members
InTime
Win32 defined data structure for holding time
and date
information
Return Value
If successful this function returns TRUE, else FALSE. If the
functions return FALSE, use GetErrorCode
to get the error code.
Comments
RTC stands for Real Time Clock. Most portable devices made by TMSi
have an
internal RTC. In some cases, the value of the RTC can be displayed on
the
device's display. It is
used to keep track of the start time of locally stored measurements. In
some
cases it can be used to automatically start a measurement at a
programmable date and time (ambulatory recording). This function is
used to write clock information to the
frontend.
The
example below demonstrates how this is done:
#include <windows.h>
SYSTEMTIME Time = {0};
GetSystemTime( &Time ); // For time in UTC
GetLocalTime( &Time ); // For time in local timezone
Status = SetRtcTime( Handle, &Time );
Keep in mind that for frontends that do not have an internal clock, the
function returns FALSE, and the error code returned by GetErrorCode
will be non-zero.
Applies to
All frontends that have an RTC. Refer to the manual of your
frontend.
Also see