Freigeben über


GetSystemTimes-Funktion (processthreadsapi.h)

Ruft Systemanzeigedauerinformationen in "Ticks" (oder 100-Nanosekundenintervallen) ab.

Syntax

BOOL GetSystemTimes(
  [out, optional] PFILETIME lpIdleTime,
  [out, optional] PFILETIME lpKernelTime,
  [out, optional] PFILETIME lpUserTime
);

Die Parameter

[out, optional] lpIdleTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit in "Ticks" empfängt, die das System im Leerlauf war.

[out, optional] lpKernelTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit in "Ticks" empfängt, die das System im Kernelmodus ausgeführt hat (einschließlich aller Threads in allen Prozessen, auf allen Prozessoren). Dieser Zeitwert enthält auch den Zeitraum, in dem das System im Leerlauf war.

[out, optional] lpUserTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit in "Ticks" empfängt, die das System im Benutzermodus ausgeführt hat (einschließlich aller Threads in allen Prozessen, auf allen Prozessoren).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Bei einem Multiprozessorsystem (mit 64 Prozessoren oder weniger) ist der zurückgegebene Wert die Summe der festgelegten Zeiten in "Ticks" für alle Prozessoren.

Hinweis

Bei Systemen mit mehr als 64 Prozessoren ist der zurückgegebene Wert die Summe der festgelegten Zeiten für die primäre Prozessorgruppe, zu der der aufrufende Thread gehört (siehe Prozessorgruppen).

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0501 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2003 [Nur Desktop-Apps]
Zielplattform Fenster
Überschrift processthreadsapi.h (include Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll