struttura BY_HANDLE_FILE_INFORMATION (fileapi.h)
Contiene informazioni recuperate dalla funzione GetFileInformationByHandle .
Sintassi
typedef struct _BY_HANDLE_FILE_INFORMATION {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD dwVolumeSerialNumber;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD nNumberOfLinks;
DWORD nFileIndexHigh;
DWORD nFileIndexLow;
} BY_HANDLE_FILE_INFORMATION, *PBY_HANDLE_FILE_INFORMATION, *LPBY_HANDLE_FILE_INFORMATION;
Members
dwFileAttributes
Attributi del file. Per i valori possibili e le relative descrizioni, vedere Costanti degli attributi file.
ftCreationTime
Struttura FILETIME che specifica quando viene creato un file o una directory. Se il file system sottostante non supporta l'ora di creazione, questo membro è zero (0).
ftLastAccessTime
Struttura FILETIME . Per un file, la struttura specifica l'ultima volta in cui un file viene letto o scritto. Per una directory, la struttura specifica quando viene creata la directory. Per i file e le directory, la data specificata è corretta, ma l'ora del giorno è sempre impostata su mezzanotte. Se il file system sottostante non supporta l'ora dell'ultimo accesso, questo membro è zero (0).
ftLastWriteTime
Struttura FILETIME . Per un file, la struttura specifica l'ultima volta in cui viene scritto un file. Per una directory, la struttura specifica quando viene creata la directory. Se il file system sottostante non supporta l'ora dell'ultima scrittura, questo membro è zero (0).
dwVolumeSerialNumber
Numero di serie del volume che contiene un file.
nFileSizeHigh
Parte di ordine elevato delle dimensioni del file.
nFileSizeLow
Parte bassa delle dimensioni del file.
nNumberOfLinks
Numero di collegamenti a questo file. Per il file system FAT questo membro è sempre 1. Per il file system NTFS, può essere maggiore di 1.
nFileIndexHigh
Parte dell'ordine elevato di un identificatore univoco associato a un file. Per altre informazioni, vedere nFileIndexLow.
nFileIndexLow
Parte in ordine basso di un identificatore univoco associato a un file.
L'identificatore (parti basse e elevate) e il numero di serie del volume identificano in modo univoco un file in un singolo computer. Per determinare se due handle aperti rappresentano lo stesso file, combinare l'identificatore e il numero di serie del volume per ogni file e confrontarli.
Il file system ReFS, introdotto con Windows Server 2012, include identificatori di file a 128 bit. Per recuperare l'identificatore di file a 128 bit, usare la funzione GetFileInformationByHandleEx con FileIdInfo per recuperare la struttura FILE_ID_INFO . L'identificatore a 64 bit in questa struttura non è garantito che sia univoco in ReFS.
Commenti
L'identificatore archiviato nei membri nFileIndexHigh e nFileIndexLow è denominato ID file. Il supporto per gli ID file è specifico del file system. Gli ID file non sono sicuramente univoci nel tempo, perché i file system sono liberi di riutilizzarli. In alcuni casi, l'ID file per un file può cambiare nel tempo.
Nel file system FAT l'ID file viene generato dal primo cluster della directory contenitore e dall'offset di byte all'interno della directory della voce per il file. Alcuni prodotti di deframmentazione modificano questo offset di byte. La deframmentazione in box di Windows non è disponibile. Di conseguenza, un ID file FAT può cambiare nel tempo. La ridenominazione di un file nel file system FAT può anche modificare l'ID file, ma solo se il nuovo nome file è più lungo di quello precedente.
Nel file system NTFS, un file mantiene lo stesso ID file fino a quando non viene eliminato. È possibile sostituire un file con un altro file senza modificare l'ID file usando la funzione ReplaceFile . Tuttavia, l'ID file del file sostitutivo, non il file sostituito, viene conservato come ID file del file risultante.
Non tutti i file system possono registrare la creazione e l'ora dell'ultimo accesso e non tutti i file system li registrano nello stesso modo. Ad esempio, in un file system FAT di Windows, l'ora 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 (la data di accesso). Nel file system NTFS il tempo di accesso ha una risoluzione di 1 ora. Per altre informazioni, vedere Orari file.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | fileapi.h (include Windows.h) |