struttura FILE_BASIC_INFORMATION (wdm.h)

Articolo
02/27/2024

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 le informazioni sul 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;

Members

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 FILE_ATTRIBUTE_XXX . Per le descrizioni di questi flag, vedere Costanti degli attributi di file nel Microsoft Windows SDK.

Commenti

Il flag FILE_ATTRIBUTE_NORMAL non può essere impostato o restituito in combinazione con altri attributi. Tutti gli altri valori FileAttributes eseguono l'override di questo attributo.

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

Se specifichi 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, LastWriteTime e 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, tutti 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 nell'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.