struttura WIN32_FIND_DATAA (minwinbase.h)

Articolo
01/10/2024

Contiene informazioni sul file trovato dalla funzione FindFirstFile, FindFirstFileEx o 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;

Members

dwFileAttributes

Attributi di file di un file.

Per i valori possibili e le relative descrizioni, vedere Costanti degli attributi 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 da, 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 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 vengono usati WriteFile o SetEndOfFile . La data e l'ora non vengono aggiornate quando vengono modificati gli attributi del 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'ora dell'ultima scrittura, questo membro è zero.

nFileSizeHigh

Valore DWORD di ordine elevato delle dimensioni del file, espresso 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 di ordine basso delle dimensioni del file, espresso 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 utilizzato.

Per altre informazioni, vedere Reparse Point Tags.For more information see 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 utilizzi futuri.

cFileName[MAX_PATH]

Nome del file.

cAlternateFileName[14]

Nome alternativo per il file.

Questo nome è nel formato classico del nome file 8.3.

Commenti

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 file, percorsi e spazi dei nomi.

Non tutti i file system possono registrare la creazione e l'ultima ora 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 Orari 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 (include Windows.h)