WIN32_FIND_DATAW struttura (minwinbase.h)
Contiene informazioni sul file trovato dalla funzione FindFirstFile, FindFirstFileEx o FindNextFile.
Sintassi
typedef struct _WIN32_FIND_DATAW {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
WCHAR cFileName[MAX_PATH];
WCHAR cAlternateFileName[14];
DWORD dwFileType; // Obsolete. Do not use.
DWORD dwCreatorType; // Obsolete. Do not use
WORD wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAW, *PWIN32_FIND_DATAW, *LPWIN32_FIND_DATAW;
Members
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 sparse.
ftCreationTime
Struttura FILETIME che specifica quando è stato creato un file o una directory.
Se il file system sottostante non supporta il tempo di creazione, questo membro è zero.
ftLastAccessTime
Struttura FILETIME .
Per un file, la struttura specifica quando il file è stato letto per l'ultima lettura, 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'ultima ora di accesso, questo membro è zero.
Nel file system FAT la data specificata per i file e 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 viene usato WriteFile o SetEndOfFile . La data e l'ora non vengono aggiornate quando vengono modificati gli attributi di file o i descrittori di sicurezza.
Per una directory, la struttura specifica quando viene creata la directory. Se il file system sottostante non supporta l'ultima ora di 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 a basso ordine delle dimensioni del file, in byte.
dwReserved0
Se il membro dwFileAttributes include l'attributo FILE_ATTRIBUTE_REPARSE_POINT , questo membro specifica il tag punto reparse.
In caso contrario, questo valore non è definito e non deve essere usato.
Per altre informazioni, vedere Tag punto reparse.
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 utilizzi futuri.
cFileName[MAX_PATH]
Nome del file.
cAlternateFileName[14]
Nome alternativo per il file.
Questo nome è nel formato di nome file 8.3 classico.
Commenti
Se un file ha un nome di file lungo, il nome completo viene visualizzato nel membro cFileName e il formato 8.3 troncato del nome viene visualizzato nel membro cAlternateFileName . In caso contrario, cAlternateFileName è vuoto. Se la funzione FindFirstFileEx è stata chiamata con un valore di 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 di formato 8.3 di un nome file, è possibile usare la funzione GetShortPathName . Per altre informazioni sui nomi dei file, vedere Nomi file, percorsi e spazi dei nomi.
Non tutti i file system possono registrare la creazione e gli ultimi tempi 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 l'ora di accesso ha una risoluzione di 1 giorno. Il file system NTFS ritarda gli aggiornamenti all'ultima ora di accesso per un file fino a 1 ora dopo l'ultimo accesso. Per altre informazioni, vedere Tempi file.
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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Intestazione | minwinbase.h (includere Windows.h) |