struttura FILE_BASIC_INFORMATION (wdm.h)

Articolo
02/07/2025

La struttura FILE_BASIC_INFORMATION contiene timestamp e attributi di base di un file. Viene utilizzato come argomento per le routine che eseguono query o impostano informazioni sui file.

Sintassi

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Membri

CreationTime

Specifica l'ora di creazione del file.

LastAccessTime

Specifica l'ora dell'ultimo accesso al file.

LastWriteTime

Specifica l'ora dell'ultima scrittura del file.

ChangeTime

Specifica l'ultima volta che il file è stato modificato.

FileAttributes

Specifica uno o più flag diXXX FILE_ATTRIBUTE_. Per le descrizioni di questi flag, vedere Costanti attributo file in Microsoft Windows SDK.

Osservazioni

Il flag FILE_ATTRIBUTE_NORMAL non può essere impostato o restituito in combinazione con altri attributi. Tutti gli altri FileAttributes valori sostituiscono questo attributo.

I valori time CreationTime, LastAccessTime, LastWriteTimee ChangeTime sono espressi in formato ora di sistema assoluto. Il tempo di sistema assoluto è il numero di intervalli di 100 nanosecondi dall'inizio dell'anno 1601 nel calendario gregoriano.

Se si specifica un valore pari a zero per uno dei membri XxxTime della struttura FILE_BASIC_INFORMATION, la funzione ZwSetInformationFile mantiene l'impostazione corrente di un file per tale ora.

Il file system aggiorna i valori dei membri LastAccessTime, LastWriteTimee membri ChangeTime in base alle esigenze dopo l'esecuzione di un'operazione di I/O in un file. Un driver o un'applicazione può richiedere che il file system non aggiorni uno o più di questi membri per le operazioni di I/O eseguite sull'handle di file del chiamante impostando i membri appropriati su -1. Il chiamante può impostare uno, tutto o qualsiasi altra combinazione di questi tre membri su -1. Solo i membri impostati su -1 non saranno interessati dalle operazioni di I/O sull'handle di file; gli altri membri verranno aggiornati in base alle esigenze. Nei sistemi NTFS e ReFS, gli aggiornamenti del timestamp sull'handle di file possono essere ripristinati impostando i membri appropriati su -2.

Per impostare i membri di questa struttura, il chiamante deve avere FILE_WRITE_ATTRIBUTES accesso al file.