Returns the current value of the system CMOS clock as a TIMEVALUE value. This value may be used to synchronize the system time, for example.

BOOLEAN GetRtHardwareClock(
    TIMEVALUE *pHwClock
);

Parameters

pHwClock

A pointer to a TIMEVALUE structure to receive the current value of the CMOS clock.

Return Values

TRUE

Success

FALSE

To determine the status, call GetLastRtError

Status

E_BAD_ADDR 0x800f

The pHwClock value is not a valid pointer to writable memory.

E_NOT_CONFIGURED 0x0008

This call is not available on INtime for Windows.

Requirements