struttura FILE_FULL_DIR_INFO (winbase.h)

  • Articolo

Contiene informazioni sulla directory per un file. Questa struttura viene restituita dalla funzione GetFileInformationByHandleEx quando fileFullDirectoryInfo o FileFullDirectoryRestartInfo viene passato nel parametro FileInformationClass .

Sintassi

typedef struct _FILE_FULL_DIR_INFO {
  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;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

Members

NextEntryOffset

Offset per la struttura FILE_FULL_DIR_INFO successiva restituita. Contiene zero (0) 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

Ora dell'ultimo accesso al file.

LastWriteTime

Ora dell'ultima scrittura del file.

ChangeTime

Ora dell'ultima modifica del file.

EndOfFile

Nuova posizione assoluta del file come offset di byte dall'inizio del file alla fine del flusso di dati predefinito del file. Poiché questo valore è in base zero, fa effettivamente riferimento al primo byte libero nel file. In altre parole, EndOfFile è l'offset al byte che segue immediatamente l'ultimo byte valido nel file.

AllocationSize

Numero di byte allocati per il file. Questo valore è in genere un multiplo del settore o delle dimensioni del cluster del dispositivo fisico sottostante.

FileAttributes

Attributi del file. Questo membro può essere qualsiasi combinazione valida degli attributi seguenti:

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

Lunghezza del nome del file.

EaSize

Dimensioni degli attributi estesi per il file.

FileName[1]

Primo carattere della stringa del nome file. Questo è seguito in memoria dal resto della stringa.

Commenti

La struttura FILE_FULL_DIR_INFO è un subset delle informazioni nella struttura FILE_ID_BOTH_DIR_INFO . Se le informazioni aggiuntive non sono necessarie, l'operazione sarà più veloce in quanto proviene dalla voce di directory; FILE_ID_BOTH_DIR_INFO contiene informazioni sia dalla voce di directory che dalla tabella file master (MFT).

Non sono necessari diritti di accesso specifici per eseguire query su queste informazioni.

Tutte le date e le ore sono in formato assoluto di ora di sistema. Il tempo di sistema assoluto è il numero di intervalli di 100 nanosecondi dall'inizio dell'anno 1601.

Questa struttura FILE_FULL_DIR_INFO deve essere allineata su un limite LONGLONG (8 byte). Se un buffer contiene due o più di queste strutture, il valore NextEntryOffset in ogni voce, ad eccezione dell'ultimo, cade su un limite di 8 byte.

Per compilare un'applicazione che usa questa struttura, definire la macro _WIN32_WINNT come 0x0600 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Intestazione winbase.h (include Windows.h)

Vedi anche

FILE_INFO_BY_HANDLE_CLASS

Strutture di gestione file

GetFileInformationByHandleEx