structure WIN32_FIND_DATAA (minwinbase.h)

Article
11/08/2024

Contient des informations sur le fichier trouvé par l'FindFirstFile , FindFirstFileExou fonction 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’attribut de fichier.

L’attribut FILE_ATTRIBUTE_SPARSE_FILE sur le fichier est défini si l’un des flux du fichier n’a jamais é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 le temps 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, s’exécuter.

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 la dernière heure d’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 du jour 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 dans, 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 la dernière heure d’écriture, ce membre est égal à zéro.

nFileSizeHigh

L’ordre élevé valeur DWORD de la taille du 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

La valeur de DWORD de la taille du 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 une utilisation ultérieure.

cFileName[MAX_PATH]

Nom du fichier.

cAlternateFileName[14]

Un autre nom pour le fichier.

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

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 apparaît dans le cAlternateFileName membre. Sinon, cAlternateFileName est vide. Si la fonction FindFirstFileEx a été appelée avec une valeur de FindExInfoBasicBasic 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 de 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 la création et les dernières heures d’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, l’heure de création a une résolution de 10 millisecondes, le temps d’écriture a une résolution de 2 secondes et l’heure d’accès a une résolution de 1 jour. Le système de fichiers NTFS retarde les mises à jour de la dernière heure d’accès d’un fichier jusqu’à 1 heure après le dernier accès. Pour plus d’informations, consultez File Times .

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
d’en-tête	minwinbase.h (include Windows.h)