Funzione SetFileTime (fileapi.h)

Articolo
08/23/2023

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