timeGetSystemTime function (timeapi.h)

Article
02/22/2024

The timeGetSystemTime function retrieves the system time, in milliseconds. The system time is the time elapsed since Windows was started. This function works very much like the timeGetTime function. See timeGetTime for details of these functions' operation.

Syntax

MMRESULT timeGetSystemTime(
  LPMMTIME pmmt,
  UINT     cbmmt
);

Parameters

pmmt

Pointer to an MMTIME structure.

cbmmt

Size, in bytes, of the MMTIME structure.

Return value

If successful, returns TIMERR_NOERROR. Otherwise, returns an error code.

Remarks

The system time is returned in the ms member of the MMTIME structure.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	timeapi.h (include Windows.h)
Library	Winmm.lib
DLL	Winmm.dll