GetSystemTimes-Funktion (processthreadsapi.h)
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 |