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 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). This time value also includes the amount of time the system has been idle.

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

Minimum supported client

Windows Vista, Windows XP with SP1 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

FILETIME
System Time
Time Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft