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
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
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
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
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.
Nota
L'intestazione minwinbase.h definisce WIN32_FIND_DATA come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [app desktop | App UWP] |
| server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| intestazione |
minwinbase.h (include Windows.h) |
Vedere anche
costanti dell'attributo file