Funzione GetFileTime (fileapi.h)
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 |