Funzione GetFileTime (fileapi.h)

Articolo
08/23/2023

Recupera la data e l'ora di creazione di un file o di una directory, dell'ultimo accesso e dell'ultima modifica.

Sintassi

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

Parametri

[in] hFile

Handle per il file o la directory per cui recuperare date e ore. L'handle deve essere stato creato usando la funzione CreateFile con il diritto di accesso GENERIC_READ . Per altre informazioni, vedere Protezione dei file e diritti di accesso.

[out, optional] lpCreationTime

Puntatore a una struttura FILETIME per ricevere la data e l'ora di creazione del file o della directory. Questo parametro può essere NULL se l'applicazione non richiede queste informazioni.

[out, optional] lpLastAccessTime

Puntatore a una struttura FILETIME per ricevere la data e l'ora dell'ultimo accesso al file o alla directory. L'ora dell'ultimo accesso include l'ultima volta in cui il file o la directory è stata scritta, letta o, nel caso di file eseguibili, eseguire. Questo parametro può essere NULL se l'applicazione non richiede queste informazioni.

[out, optional] lpLastWriteTime

Puntatore a una struttura FILETIME per ricevere la data e l'ora dell'ultima scrittura, troncamento o sovrascritto del file o della directory, ad esempio con WriteFile o SetEndOfFile. Questa data e ora non vengono aggiornate quando vengono modificati gli attributi del file o i descrittori di sicurezza. Questo parametro può essere NULL se l'applicazione non richiede queste informazioni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Non tutti i file system possono registrare la creazione e l'ultima volta di accesso e non tutti i file system li registrano nello stesso modo. Ad esempio, in FAT, il tempo di creazione ha una risoluzione di 10 millisecondi, il tempo di scrittura ha una risoluzione di 2 secondi e l'ora di accesso ha una risoluzione di 1 giorno (in realtà, la data di accesso). Pertanto, la funzione GetFileTime potrebbe non restituire le stesse informazioni di ora file impostate usando la funzione SetFileTime .

NTFS ritarda gli aggiornamenti all'ultima ora di accesso per un file fino a un'ora dopo l'ultimo accesso. NTFS consente inoltre di disabilitare gli aggiornamenti dell'ora dell'ultimo accesso. L'ora dell'ultimo accesso non viene aggiornata nei volumi NTFS per impostazione predefinita.

Windows Server 2003 e Windows XP: L'ora dell'ultimo accesso viene aggiornata nei volumi NTFS per impostazione predefinita.

Per altre informazioni, vedere Orari file.

Se si rinomina o si elimina un file, ripristinarlo poco dopo, Windows cerca nella cache le informazioni sui file da ripristinare. Le informazioni memorizzate nella cache includono la relativa coppia nome breve/lungo e il tempo di creazione.

Esempio

Per un esempio, vedere Recupero dell'ora di Last-Write.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll