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

Syntax

BOOL WINAPI GetSystemTimes(
  __out_opt  LPFILETIME lpIdleTime,
  __out_opt  LPFILETIME lpKernelTime,
  __out_opt  LPFILETIME lpUserTime
);

Parameters

lpIdleTime [out, optional]

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

lpKernelTime [out, optional]

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).

lpUserTime [out, optional]

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

See Also

FILETIME

System Time

Time Functions

Send comments about this topic to Microsoft

Build date: 11/19/2009