struttura FILE_DIRECTORY_INFORMATION (ntifs.h)
La struttura FILE_DIRECTORY_INFORMATION viene usata per eseguire query dettagliate sui file in una directory.
Sintassi
typedef struct _FILE_DIRECTORY_INFORMATION {
ULONG NextEntryOffset;
ULONG FileIndex;
LARGE_INTEGER CreationTime;
LARGE_INTEGER LastAccessTime;
LARGE_INTEGER LastWriteTime;
LARGE_INTEGER ChangeTime;
LARGE_INTEGER EndOfFile;
LARGE_INTEGER AllocationSize;
ULONG FileAttributes;
ULONG FileNameLength;
WCHAR FileName[1];
} FILE_DIRECTORY_INFORMATION, *PFILE_DIRECTORY_INFORMATION;
Membri
NextEntryOffset
Offset di byte della voce FILE_DIRECTORY_INFORMATION successiva, se in un buffer sono presenti più voci. Questo membro è zero se nessun'altra voce segue questa.
FileIndex
Offset di byte del file all'interno della directory padre. Questo membro non è definito per i file system, ad esempio NTFS, in cui la posizione di un file all'interno della directory padre non è fissa e può essere modificata in qualsiasi momento per mantenere l'ordinamento.
CreationTime
Ora di creazione del file.
LastAccessTime
Ultima volta che è stato eseguito l'accesso al file.
LastWriteTime
L'ultima volta che le informazioni sono state scritte nel file.
ChangeTime
Ora dell'ultima modifica del file.
EndOfFile
Nuova posizione assoluta di fine del file come offset di byte dall'inizio del file. EndOfFile specifica l'offset di byte alla fine del file. Poiché questo valore è in base zero, si riferisce effettivamente al primo byte libero nel file. In altre parole, EndOfFile è l'offset al byte immediatamente successivo all'ultimo byte valido nel file.
AllocationSize
Dimensioni di allocazione dei file, in byte. In genere, questo valore è un multiplo delle dimensioni del settore o del cluster del dispositivo fisico sottostante.
FileAttributes
Attributi di file, che possono essere qualsiasi combinazione valida dei seguenti elementi:
- FILE_ATTRIBUTE_ARCHIVE
- FILE_ATTRIBUTE_COMPRESSED
- FILE_ATTRIBUTE_DIRECTORY
- FILE_ATTRIBUTE_HIDDEN
- FILE_ATTRIBUTE_NORMAL
- FILE_ATTRIBUTE_READONLY
- FILE_ATTRIBUTE_SYSTEM
- FILE_ATTRIBUTE_TEMPORARY
FileNameLength
Specifica la lunghezza della stringa del nome file.
FileName[1]
Specifica il primo carattere della stringa del nome file. Questo è seguito in memoria dal resto della stringa.
Osservazioni
Queste informazioni possono essere sottoposte a query in uno dei modi seguenti:
- Chiamare ZwQueryDirectoryFile, passando FileDirectoryInformation come valore di FileInformationClass e passando un buffer allocato dal chiamante FILE_DIRECTORY_INFORMATION strutturato come valore di FileInformation.
- Creare un IRP con codice funzione principale IRP_MJ_DIRECTORY_CONTROL e codice di funzione secondaria IRP_MN_QUERY_DIRECTORY.
Non sono necessari diritti di accesso specifici per eseguire query su queste informazioni.
Tutte le date e le ore sono in formato di sistema assoluto. Il tempo di sistema assoluto è il numero di intervalli di 100 nanosecondi dall'inizio dell'anno 1601.
Questa struttura deve essere allineata su un limite LONGLONG (8 byte). Se un buffer contiene due o più di queste strutture, il NextEntryOffset valore in ogni voce, tranne l'ultimo, cade su un limite di 8 byte.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione |
ntifs.h (include Ntifs.h, Fltkernel.h) |