GetSystemTimes-Funktion (processthreadsapi.h)

  • Artikel

Ruft Informationen zur Systemzeitsteuerung ab. Auf einem Multiprozessorsystem sind die zurückgegebenen Werte die Summe der angegebenen Zeiten für alle Prozessoren.

Syntax

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

Parameter

[out, optional] lpIdleTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeitspanne empfängt, in der sich das System im Leerlauf befindet.

[out, optional] lpKernelTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit empfängt, die das System für die Ausführung im Kernelmodus aufgewendet hat (einschließlich aller Threads in allen Prozessen, auf allen Prozessoren). Dieser Zeitwert enthält auch die Zeitspanne, in der sich das System im Leerlauf befunden hat.

[out, optional] lpUserTime

Ein Zeiger auf eine FILETIME-Struktur , die die Zeit empfängt, die das System für die Ausführung im Benutzermodus aufgewendet 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 fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (include Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

FILETIME

Systemzeit

Zeitfunktionen