getProcessTimes 函数 (processthreadsapi.h)

项目
03/05/2024

检索指定进程的计时信息。

语法

BOOL GetProcessTimes(
  [in]  HANDLE     hProcess,
  [out] LPFILETIME lpCreationTime,
  [out] LPFILETIME lpExitTime,
  [out] LPFILETIME lpKernelTime,
  [out] LPFILETIME lpUserTime
);

参数

[in] hProcess

要获取其计时信息的进程的句柄。句柄必须具有 PROCESS_QUERY_INFORMATION 或 PROCESS_QUERY_LIMITED_INFORMATION 访问权限。有关详细信息，请参阅进程安全和访问权限。

Windows Server 2003 和 Windows XP： 句柄必须具有 PROCESS_QUERY_INFORMATION 访问权限。

[out] lpCreationTime

指向 FILETIME 结构的指针，该结构接收进程的创建时间。

[out] lpExitTime

指向 FILETIME 结构的指针，该结构接收进程的退出时间。如果进程尚未退出，则此结构的内容未定义。

[out] lpKernelTime

指向 FILETIME 结构的指针，该结构接收进程在内核模式下执行的时间。确定进程的每个线程在内核模式下执行的时间，然后将所有这些时间相加以获取此值。

[out] lpUserTime

指向 FILETIME 结构的指针，该结构接收进程在用户模式下执行的时间。确定进程的每个线程在用户模式下执行的时间，然后将所有这些时间相加以获取此值。请注意，如果进程跨多个 CPU 核心执行，则此值可能会超过 lpCreationTime 和 lpExitTime) 之间经过的实时 (量。

返回值

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

所有时间都使用 FILETIME 数据结构表示。此类结构包含两个 32 位值，这些值组合在一起形成 100 纳秒时间单位的 64 位计数。

进程创建和退出时间是时间点，表示自 1601 年 1 月 1 日午夜以来在英国格林威治经过的时间量。应用程序可以使用多个函数将此类值转换为更普遍有用的形式。

进程内核模式和用户模式时间是时间。例如，如果进程在内核模式下花费了一秒钟，此函数将使用 64 位值 1000 万填充 lpKernelTime 指定的 FILETIME 结构。这是一秒内 100 纳秒单位的数目。

若要检索进程线程使用的 CPU 时钟周期数，请使用 QueryProcessCycleTime 函数。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	processthreadsapi.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
Library	Kernel32.lib
DLL	Kernel32.dll