RtlTimeToSecondsSince1970-Funktion (winternl.h)

Artikel
02/01/2024

[RtlTimeToSecondsSince1970 ist für die Verwendung in Windows 2000 und Windows XP verfügbar. Es kann nicht verfügbar oder in nachfolgenden Versionen geändert werden.]

Konvertiert die angegebene 64-Bit-Systemzeit in die Anzahl von Sekunden seit Anfang des 1. Januar 1970.

Syntax

BOOLEAN RtlTimeToSecondsSince1970(
  [in]  PLARGE_INTEGER Time,
  [out] PULONG         ElapsedSeconds
);

Parameter

[in] Time

Ein Zeiger auf eine LARGE_INTEGER-Struktur , die die Systemzeit angibt. Die gültigen Jahre für diesen Wert sind 1970 bis einschließlich 2105.

[out] ElapsedSeconds

Ein Zeiger auf eine Variable, die die Anzahl der Sekunden empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben. Wenn ein Fehler auftritt, wird FALSE zurückgegeben. In der Regel schlägt diese Funktion fehl, wenn der angegebene Wert des Time-Parameters nicht innerhalb des in der Parameterbeschreibung angegebenen gültigen Zeitrahmens liegt.

Hinweise

Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Ntdll.dll zu verknüpfen.

Es gibt keine einzige gleichwertige öffentliche Funktion. Führen Sie die folgenden Schritte aus, um diese Aufgabe mit öffentlichen Funktionen auszuführen:

Rufen Sie SystemTimeToFileTime auf, um die Systemzeit in eine FILETIME-Struktur zu kopieren. Rufen Sie GetSystemTime auf, um die aktuelle Systemzeit abzurufen, die an SystemTimeToFileTime übergeben werden soll.
Kopieren Sie den Inhalt der FILETIME-Struktur in eine ULARGE_INTEGER-Struktur .
Initialisieren Sie eine SYSTEMTIME-Struktur mit dem Datum und der Uhrzeit der ersten Sekunde des 1. Januar 1970.
Rufen Sie SystemTimeToFileTime auf, und übergeben Sie die in Schritt 3 initialisierte SYSTEMTIME-Struktur an den Aufruf.
Kopieren Sie den Inhalt der FILETIME-Struktur , die von SystemTimeToFileTime in Schritt 4 zurückgegeben wurde, in eine zweite ULARGE_INTEGER. Der kopierte Wert sollte kleiner oder gleich dem in Schritt 2 kopierten Wert sein.
Subtrahieren Sie den 64-Bit-Wert in der ULARGE_INTEGER-Struktur , die in Schritt 5 (1. Januar 1970) initialisiert wurde, vom 64-Bit-Wert der in Schritt 2 initialisierten ULARGE_INTEGER-Struktur (die aktuelle Systemzeit). Dies erzeugt seit dem 1. Januar 1970 einen Wert in Intervallen von 100 Nanosekunden. Um diesen Wert in Sekunden zu konvertieren, dividieren Sie durch 10.000.000.