Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les constantes d’attribut de fichier définissent les valeurs de métadonnées stockées par le système de fichiers sur le disque et sont utilisées par le système et disponibles pour les développeurs via diverses API d’E/S de fichier. Ces constantes permettent aux développeurs de vérifier et de définir des propriétés de fichier telles que des attributs en lecture seule, masqués ou compressés. Pour obtenir la liste des API et rubriques connexes, consultez la section Voir aussi .
Example
FILE_BASIC_INFO basicInfo;
BOOL result;
result = GetFileInformationByHandleEx( hFile,
FileBasicInfo,
&basicInfo,
sizeof(basicInfo));
\\...
printf(" File Attributes: ");
PrintFileAttributes(basicInfo.FileAttributes);
\\...
VOID
PrintFileAttributes(
ULONG FileAttributes
)
{
if (FileAttributes & FILE_ATTRIBUTE_ARCHIVE) {
printf("Archive ");
}
if (FileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
printf("Directory ");
}
if (FileAttributes & FILE_ATTRIBUTE_READONLY) {
printf("Read-Only ");
}
}
Exemple extrait d’un exemple Windows Classic sur GitHub.
| Constante/valeur | Descriptif |
|---|---|
|
Fichier en lecture seule. Les applications peuvent lire le fichier, mais ne peuvent pas y écrire ou le supprimer. Cet attribut n’est pas honoré sur les répertoires. |
|
Le fichier ou le répertoire est masqué. Il n’est pas inclus dans une liste d’annuaires ordinaire. |
|
Fichier ou répertoire dont le système d’exploitation utilise une partie ou utilise exclusivement. |
|
Handle qui identifie un répertoire. |
|
Fichier ou répertoire qui est un fichier ou un répertoire d’archivage. Les applications utilisent généralement cet attribut pour marquer les fichiers pour la sauvegarde ou la suppression. |
|
Cette valeur est réservée pour une utilisation système. |
|
Fichier qui n’a pas d’autres attributs définis. Cet attribut est valide uniquement lorsqu’il est utilisé seul. |
|
Fichier utilisé pour le stockage temporaire. Les systèmes de fichiers évitent d’écrire des données dans le stockage en masse si la mémoire du cache suffisante est disponible, car en général, une application supprime un fichier temporaire une fois le handle fermé. Dans ce scénario, le système peut tout à fait éviter d’écrire les données. Sinon, les données sont écrites après la fermeture du handle. |
|
Fichier partiellement alloué. |
|
Fichier ou répertoire qui a un point d’analyse associé ou un fichier qui est un lien symbolique. |
|
Fichier ou répertoire compressé. Pour un fichier, toutes les données du fichier sont compressées. Pour un répertoire, la compression est la valeur par défaut pour les fichiers et sous-répertoires nouvellement créés. |
|
Les données d’un fichier ne sont pas disponibles immédiatement. Cet attribut indique que les données de fichier sont physiquement déplacées vers le stockage hors connexion. Cet attribut est utilisé par le stockage distant, qui est le logiciel de gestion de stockage hiérarchique. Les applications ne doivent pas modifier arbitrairement cet attribut. |
|
Le fichier ou le répertoire ne doit pas être indexé par le service d’indexation de contenu. |
|
Fichier ou répertoire chiffré. Pour un fichier, tous les flux de données du fichier sont chiffrés. Pour un répertoire, le chiffrement est la valeur par défaut pour les fichiers et sous-répertoires nouvellement créés. |
|
Le flux de données utilisateur ou d’annuaire est configuré avec intégrité (pris en charge uniquement sur les volumes ReFS). Il n’est pas inclus dans une liste d’annuaires ordinaire. Le paramètre d’intégrité persiste avec le fichier s’il est renommé. Si un fichier est copié, le fichier de destination a un jeu d’intégrité si le fichier source ou le répertoire de destination ont un jeu d’intégrité. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge tant que Windows Server 2012 n’est pas pris en charge. |
|
Cette valeur est réservée pour une utilisation système. |
|
Le flux de données utilisateur ne doit pas être lu par le scanneur d’intégrité des données en arrière-plan (nettoyage AKA). Lorsqu’il est défini sur un répertoire, il fournit uniquement l’héritage. Cet indicateur est pris en charge uniquement sur les espaces de stockage et les volumes ReFS. Il n’est pas inclus dans une liste d’annuaires ordinaire. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cet indicateur n’est pas pris en charge tant que Windows 8 et Windows Server 2012 ne sont pas pris en charge. |
|
Un fichier ou un répertoire avec des attributs étendus. IMPORTANT: Cette constante est destinée uniquement à une utilisation interne. |
|
Cet attribut indique l’intention de l’utilisateur que le fichier ou le répertoire doit être conservé entièrement présent localement, même en cas d’accès actif. Cet attribut est utilisé avec un logiciel de gestion de stockage hiérarchique. |
|
Cet attribut indique que le fichier ou le répertoire ne doit pas être conservé entièrement présent localement, sauf en cas d’accès actif. Cet attribut est utilisé avec un logiciel de gestion de stockage hiérarchique. |
|
Cet attribut apparaît uniquement dans les classes d’énumération d’annuaire (FILE_DIRECTORY_INFORMATION, FILE_BOTH_DIR_INFORMATION, etc.). Lorsque cet attribut est défini, cela signifie que le fichier ou le répertoire n’a aucune représentation physique sur le système local ; l’élément est virtuel. L’ouverture de l’élément sera plus coûteuse que la normale, par exemple, elle provoquera au moins une extraction à partir d’un magasin distant. |
|
Lorsque cet attribut est défini, cela signifie que le fichier ou le répertoire n’est pas entièrement présent localement. Pour un fichier qui signifie que toutes ses données ne sont pas sur le stockage local (par exemple, il peut être partiellement alloué avec certaines données toujours dans le stockage distant). Pour un répertoire, cela signifie que certains contenus du répertoire sont virtualisés à partir d’un autre emplacement. La lecture du fichier / énumération du répertoire sera plus coûteuse que la normale, par exemple, elle provoquera au moins une partie du contenu du fichier/répertoire à extraire à partir d’un magasin distant. Seuls les appelants en mode noyau peuvent définir ce bit. Les mini filtres du système de fichiers inférieurs à 180000 – 189999 plage d’altitude (FSFilter HSM Load Order Group) ne doivent pas émettre de lectures ou d’écritures mises en cache ciblées dans des fichiers dont cet attribut est défini. Cela pourrait entraîner une pollution du cache et une corruption potentielle des fichiers. Pour plus d’informations, consultez Gestion des espaces réservés. |
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Header | WinNT.h (inclure Windows.h) |