struttura WIN32_FIND_DATAA (minwinbase.h)

Contiene informazioni sul file trovato dalla funzione FindFirstFile, FindFirstFileExo FindNextFile.

Sintassi

typedef struct _WIN32_FIND_DATAA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  CHAR     cFileName[MAX_PATH];
  CHAR     cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;

Membri

dwFileAttributes

Attributi di file di un file.

Per i valori possibili e le relative descrizioni, vedere Costanti attributo file.

L'attributo FILE_ATTRIBUTE_SPARSE_FILE nel file viene impostato se uno dei flussi del file è mai stato di tipo sparse.

ftCreationTime

Struttura FILETIME che specifica quando è stato creato un file o una directory.

Se il file system sottostante non supporta l'ora di creazione, questo membro è zero.

ftLastAccessTime

Struttura FILETIME.

Per un file, la struttura specifica quando il file è stato letto per l'ultima volta, scritto in o per i file eseguibili, eseguire.

Per una directory, la struttura specifica quando viene creata la directory. Se il file system sottostante non supporta l'ora dell'ultimo accesso, questo membro è zero.

Nel file system FAT la data specificata sia per i file che per le directory è corretta, ma l'ora del giorno è sempre impostata su mezzanotte.

ftLastWriteTime

Struttura FILETIME.

Per un file, la struttura specifica quando il file è stato scritto per l'ultima volta, troncato o sovrascritto, ad esempio quando vengono utilizzati WriteFile o SetEndOfFile. La data e l'ora non vengono aggiornate quando vengono modificati attributi di file o descrittori di sicurezza.

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.

nFileSizeHigh

Valore DWORD di ordine elevato delle dimensioni del file, in byte.

Questo valore è zero a meno che le dimensioni del file non siano maggiori di MAXDWORD.

Le dimensioni del file sono uguali a (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

Valore DWORD basso delle dimensioni del file, in byte.

dwReserved0

Se il membro dwFileAttributes include l'attributo FILE_ATTRIBUTE_REPARSE_POINT, questo membro specifica il tag reparse point.

In caso contrario, questo valore non è definito e non deve essere usato.

Per altre informazioni, vedere Reparse Point Tags.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

Riservato per uso futuro.

cFileName[MAX_PATH]

Nome del file.

cAlternateFileName[14]

Nome alternativo per il file.

Questo nome è nel formato classico del nome file 8.3.

Osservazioni

Se un file ha un nome di file lungo, il nome completo viene visualizzato nel membro cFileName e la versione 8.3 troncata del nome viene visualizzata nel membro cAlternateFileName. In caso contrario, cAlternateFileName è vuoto. Se la funzione FindFirstFileEx è stata chiamata con un valore FindExInfoBasic nel parametro fInfoLevelId, il membro cAlternateFileName conterrà sempre un valore stringa NULL. Ciò rimane true per tutte le chiamate successive alla funzione FindNextFile. Come metodo alternativo per recuperare la versione del formato 8.3 di un nome file, è possibile usare la funzione GetShortPathName . Per altre informazioni sui nomi di file, vedere nomi di file, percorsi e spazi dei nomi.

Non tutti i file system possono registrare la creazione e l'ultima volta di accesso e non tutti i file system li registrano nello stesso modo. Ad esempio, nel file system FAT, il tempo di creazione ha una risoluzione di 10 millisecondi, il tempo di scrittura ha una risoluzione di 2 secondi e il tempo di accesso ha una risoluzione di 1 giorno. Il file system NTFS ritarda gli aggiornamenti all'ora dell'ultimo accesso per un file fino a 1 ora dopo l'ultimo accesso. Per altre informazioni, vedere File Times.

Fabbisogno

Vedere anche

FILETIME

costanti dell'attributo file

nomi, percorsi e spazi dei nomi

tempi di file

FileTimeToLocalFileTime

FileTimeToSystemTime

FindFirstFile

FindFirstFileEx

FindNextFile

GetShortPathName