Funzione RtlTimeToSecondsSince1970 (winternl.h)

Articolo
03/04/2024

[RtlTimeToSecondsSince1970 è disponibile per l'uso in Windows 2000 e Windows XP. Potrebbe non essere disponibile o modificato nelle versioni successive.

Converte il tempo di sistema a 64 bit specificato nel numero di secondi dall'inizio del 1° gennaio 1970.

Sintassi

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

Parametri

[in] Time

Puntatore a una struttura LARGE_INTEGER che specifica l'ora di sistema. Gli anni validi per questo valore sono compresi tra 1970 e 2105.

[out] ElapsedSeconds

Puntatore a una variabile che riceve il numero di secondi.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. Se ha esito negativo, restituisce FALSE. In genere, questa funzione avrà esito negativo se il valore specificato del parametro Time non rientra nell'intervallo di tempo valido specificato nella descrizione del parametro.

Commenti

Questa funzione non ha una libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Ntdll.dll.

Non esiste una singola funzione pubblica equivalente. Per eseguire questa attività usando le funzioni pubbliche, seguire questa procedura:

Chiamare SystemTimeToFileTime per copiare l'ora di sistema in una struttura FILETIME . Chiamare GetSystemTime per ottenere l'ora di sistema corrente da passare a SystemTimeToFileTime.
Copiare il contenuto della struttura FILETIME in una struttura ULARGE_INTEGER .
Inizializzare una struttura SYSTEMTIME con la data e l'ora del primo secondo gennaio 1970.
Chiamare SystemTimeToFileTime passando la struttura SYSTEMTIME inizializzata nel passaggio 3 alla chiamata.
Copiare il contenuto della struttura FILETIME restituita da SystemTimeToFileTime nel passaggio 4 in un secondo ULARGE_INTEGER. Il valore copiato deve essere minore o uguale al valore copiato nel passaggio 2.
Sottrarre il valore a 64 bit nella struttura ULARGE_INTEGER inizializzata nel passaggio 5 (1 gennaio 1970) dal valore a 64 bit della struttura ULARGE_INTEGER inizializzata nel passaggio 2 (ora di sistema corrente). Questo produce un valore in intervalli di 100 nanosecondi dal 1° gennaio 1970. Per convertire questo valore in secondi, dividere per 10.000.000.