GetSystemTimes function

Retrieves system timing information. On a multiprocessor system, the values returned are the sum of the designated times across all processors.

Syntax

BOOL GetSystemTimes(
  PFILETIME lpIdleTime,
  PFILETIME lpKernelTime,
  PFILETIME lpUserTime
);

Parameters

lpIdleTime

A pointer to a FILETIME structure that receives the amount of time that the system has been idle.

lpKernelTime

A pointer to a FILETIME structure that receives the amount of time that the system has spent executing in Kernel mode (including all threads in all processes, on all processors). This time value also includes the amount of time the system has been idle.

lpUserTime

A pointer to a FILETIME structure that receives the amount of time that the system has spent executing in User mode (including all threads in all processes, on all processors).

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

To compile an application that uses this function, define _WIN32_WINNT as 0x0501 or later. For more information, see Using the Windows Headers.

Requirements

   
Minimum supported client Windows Vista, Windows XP with SP1 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header processthreadsapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

FILETIME

System Time

Time Functions