structure WIN32_FIND_DATAW (minwinbase.h)
Contient des informations sur le fichier trouvé par la fonction FindFirstFile, FindFirstFileEx ou FindNextFile.
Syntaxe
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;
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 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 le moment où le fichier a été lu, écrit dans ou pour les fichiers exécutables, exécuté pour la dernière fois.
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 le moment où 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 dernière écriture, ce membre est égal à zéro.
nFileSizeHigh
Valeur DWORD d’ordre élevé 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
Valeur DWORD de faible ordre 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 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 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 tronquée au format 8.3 du nom apparaît dans le membre cAlternateFileName . Sinon, cAlternateFileName est vide. Si la fonction FindFirstFileEx a été appelée avec une valeur FindExInfoBasic dans le paramètre fInfoLevelId , le membre cAlternateFileName contiendra 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 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 du dernier accès d’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 comme un 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.
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) |
Voir aussi
Constantes d’attribut des fichiers
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour