WIN32_FIND_DATAW struttura (minwinbase.h)

Articolo
03/05/2024

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)