CeGetRawTime (Compact 2013)

3/28/2014

This function reads the real-time clock (RTC) and offsets it with the offset value that is calculated on every time change. The monotonically increasing clock is guaranteed to run at the speed of the RTC. The absolute value is meaningless because it is not guaranteed to be related to the local time or the system time in any way.

Syntax

BOOL CeGetRawTime(
    ULONGLONG * pui64Millsec
);

Parameters

  • pi64Time
    [out] Pointer to a unsigned 64-bit value to receive monotonically increasing time, in milliseconds.

Return Value

TRUE indicates success. FALSE indicates failure. For more information, call GetLastError.

Remarks

The time returned from CeGetRawTime is only guaranteed to be monotonically increasing in-between boots. For services that require elapsed time across boots, do the following:

  • Register time change notification.
  • When notified of time change, read the current raw-time offset with CeGetRawTimeOffset, and persist the offset with method applicable.
  • Take into account the persisted offset on elapse time calculation.

Requirements

Header

pkfuncs.h

Library

coredll.lib

See Also

Reference

Time Functions
CeGetRawTimeOffset