WIN32_FIND_DATAA structure (minwinbase.h)

Article
01/10/2024

Contient des informations sur le fichier trouvé par la fonction FindFirstFile, FindFirstFileEx ou FindNextFile.

Syntaxe

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;

Membres

dwFileAttributes

Attributs de fichier d’un fichier.

Pour connaître les valeurs possibles et leurs descriptions, consultez Constantes d’attributs de fichier.

L’attribut FILE_ATTRIBUTE_SPARSE_FILE sur le fichier est défini si l’un des flux du fichier a déjà été partiellement alloué.

ftCreationTime

Structure FILETIME qui spécifie quand un fichier ou un répertoire a été créé.

Si le système de fichiers sous-jacent ne prend pas en charge la durée de création, ce membre est égal à zéro.

ftLastAccessTime

Structure FILETIME .

Pour un fichier, la structure spécifie quand le fichier a été lu pour la dernière fois, écrit dans ou pour les fichiers exécutables, exécuté.

Pour un répertoire, la structure spécifie quand le répertoire est créé. Si le système de fichiers sous-jacent ne prend pas en charge l’heure du dernier accès, ce membre est égal à zéro.

Sur le système de fichiers FAT, la date spécifiée pour les fichiers et les répertoires est correcte, mais l’heure de la journée est toujours définie sur minuit.

ftLastWriteTime

Structure FILETIME .

Pour un fichier, la structure spécifie quand le fichier a été écrit pour la dernière fois, tronqué ou remplacé, par exemple, quand WriteFile ou SetEndOfFile sont utilisés. La date et l’heure ne sont pas mises à jour lorsque les attributs de fichier ou les descripteurs de sécurité sont modifiés.

Pour un répertoire, la structure spécifie quand le répertoire est créé. Si le système de fichiers sous-jacent ne prend pas en charge l’heure de la dernière écriture, ce membre est égal à zéro.

nFileSizeHigh

Valeur DWORD d’ordre élevé de la taille de fichier, en octets.

Cette valeur est égale à zéro, sauf si la taille du fichier est supérieure à MAXDWORD.

La taille du fichier est égale à (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

Valeur DWORD d’ordre inférieur de la taille de fichier, en octets.

dwReserved0

Si le membre dwFileAttributes inclut l’attribut FILE_ATTRIBUTE_REPARSE_POINT , ce membre spécifie la balise de point d’analyse.

Sinon, cette valeur n’est pas définie et ne doit pas être utilisée.

Pour plus d’informations , consultez Balises de point d’analyse.

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

Réservé pour un usage futur.

cFileName[MAX_PATH]

Nom du fichier.

cAlternateFileName[14]

Autre nom pour le fichier.

Ce nom est au format de nom de fichier classique 8.3.

Remarques

Si un fichier a un nom de fichier long, le nom complet apparaît dans le membre cFileName et la version 8.3 tronquée du nom s’affiche dans le membre cAlternateFileName . Sinon, cAlternateFileName est vide. Si la fonction FindFirstFileEx a été appelée avec la valeur FindExInfoBasic dans le paramètre fInfoLevelId , le membre cAlternateFileName contient toujours une valeur de chaîne NULL . Cela reste vrai pour tous les appels suivants à la fonction FindNextFile . Pour récupérer la version au format 8.3 d’un nom de fichier, vous pouvez utiliser la fonction GetShortPathName . Pour plus d’informations sur les noms de fichiers, consultez Noms de fichiers, chemins d’accès et espaces de noms.

Tous les systèmes de fichiers ne peuvent pas enregistrer les heures de création et de dernier accès, et tous les systèmes de fichiers ne les enregistrent pas de la même manière. Par exemple, sur le système de fichiers FAT, le temps de création a une résolution de 10 millisecondes, le temps d’écriture a une résolution de 2 secondes et le temps d’accès a une résolution de 1 jour. Le système de fichiers NTFS retarde les mises à jour jusqu’à l’heure du dernier accès pour un fichier jusqu’à 1 heure après le dernier accès. Pour plus d’informations, consultez Heures de fichiers.

Notes

L’en-tête minwinbase.h définit WIN32_FIND_DATA en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
En-tête	minwinbase.h (inclure Windows.h)