Funzione SetFileTime (fileapi.h)
Imposta la data e l'ora di creazione del file o della directory specificata, dell'ultimo accesso o dell'ultima modifica.
Sintassi
BOOL SetFileTime(
[in] HANDLE hFile,
[in, optional] const FILETIME *lpCreationTime,
[in, optional] const FILETIME *lpLastAccessTime,
[in, optional] const FILETIME *lpLastWriteTime
);
Parametri
[in] hFile
Handle nel file o nella directory. L'handle deve essere stato creato usando la funzione CreateFile con il diritto di accesso FILE_WRITE_ATTRIBUTES . Per altre informazioni, vedere Sicurezza file e diritti di accesso.
[in, optional] lpCreationTime
Puntatore a una struttura FILETIME contenente la nuova data di creazione e l'ora per il file o la directory. Se l'applicazione non deve modificare queste informazioni, impostare questo parametro su o su un puntatore a NULL una struttura FILETIME con membri dwLowDateTime e dwHighDateTime impostati su 0.
[in, optional] lpLastAccessTime
Puntatore a una struttura FILETIME contenente la nuova data di accesso e l'ora dell'ultimo accesso per il file o la directory. L'ultima volta di accesso include l'ultima volta che il file o la directory è stata scritta, letti da o (nel caso di file eseguibili) eseguire. Se l'applicazione non deve modificare queste informazioni, impostare questo parametro su o su un puntatore a NULL una struttura FILETIME con membri dwLowDateTime e dwHighDateTime impostati su 0.
Per impedire l'uso dell'handle specificato, chiamare SetFileTime immediatamente dopo l'apertura dell'handle file e passare una struttura FILETIME con i membri dwLowDateTime e dwHighDateTime impostati su 0xFFFFFFFF.
[in, optional] lpLastWriteTime
Puntatore a una struttura FILETIME contenente la nuova data e l'ora dell'ultima modifica per il file o la directory. Se l'applicazione non deve modificare queste informazioni, impostare questo parametro su o su un puntatore a NULL una struttura FILETIME con membri dwLowDateTime e dwHighDateTime impostati su 0.
Per impedire alle operazioni di file di usare l'handle specificato di modificare l'ultima ora di scrittura, chiamare SetFileTime immediatamente dopo l'apertura dell'handle file e passare una struttura FILETIME con i membri dwLowDateTime e dwHighDateTime impostati su 0xFFFFFFFF.
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 lo stesso set di informazioni sull'ora di file usando SetFileTime. I ritardi NTFS vengono aggiornati all'ultima ora di accesso per un file fino a un'ora dopo l'ultimo accesso.
Esempio
Per un esempio, vedere Modifica di un'ora file all'ora corrente.
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 (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |