SetFileAttributesA, fonction (fileapi.h)
Définit les attributs d’un fichier ou d’un répertoire.
Pour effectuer cette opération en tant qu’opération transactionnelle, utilisez la fonction SetFileAttributesTransacted .
Syntaxe
BOOL SetFileAttributesA(
[in] LPCSTR lpFileName,
[in] DWORD dwFileAttributes
);
Paramètres
[in] lpFileName
Nom du fichier dont les attributs doivent être définis.
Par défaut, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères de large, ajoutez « \\?\ » au chemin d’accès. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.
Conseil
À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation de MAX_PATH sans précédencer « \?\ ». Pour plus d’informations, consultez la section « Limitation de longueur maximale du chemin d’accès » dans Naming Files, Paths et Namespaces .
[in] dwFileAttributes
Attributs de fichier à définir pour le fichier.
Ce paramètre peut être une ou plusieurs valeurs, combinées à l’aide de l’opérateur or au niveau du bit. Toutefois, toutes les autres valeurs remplacent FILE_ATTRIBUTE_NORMAL.
Tous les attributs ne sont pas pris en charge par cette fonction. Pour plus d'informations, consultez la section Notes.
Voici une liste des valeurs d’attribut prises en charge.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Le tableau suivant décrit comment définir les attributs qui ne peuvent pas être définis à l’aide de SetFileAttributes. Pour obtenir la liste complète de toutes les valeurs d’attribut de fichier et leurs descriptions, consultez Constantes des attributs de fichier.
| Attribut | Guide pratique pour définir |
|---|---|
|
FILE_ATTRIBUTE_COMPRESSED
0x800 |
Pour définir l’état de compression d’un fichier, utilisez la fonction DeviceIoControl avec l’opération FSCTL_SET_COMPRESSION . |
|
FILE_ATTRIBUTE_DEVICE
0x40 |
Réservés au; n’utilisez pas. |
|
FILE_ATTRIBUTE_DIRECTORY
0x10 |
Les fichiers ne peuvent pas être convertis en répertoires. Pour créer un répertoire, utilisez la fonction CreateDirectory ou CreateDirectoryEx . |
|
FILE_ATTRIBUTE_ENCRYPTED
0x4000 |
Pour créer un fichier chiffré, utilisez la fonction CreateFile avec l’attribut FILE_ATTRIBUTE_ENCRYPTED . Pour convertir un fichier existant en fichier chiffré, utilisez la fonction EncryptFile . |
|
FILE_ATTRIBUTE_REPARSE_POINT
0x400 |
Pour associer un point d’analyse à un fichier ou un répertoire, utilisez la fonction DeviceIoControl avec l’opération FSCTL_SET_REPARSE_POINT . |
|
FILE_ATTRIBUTE_SPARSE_FILE
0x200 |
Pour définir l’attribut éparse d’un fichier, utilisez la fonction DeviceIoControl avec l’opération FSCTL_SET_SPARSE . |
Opérations traitées
Si un fichier est ouvert pour modification dans une transaction, aucun autre thread ne peut ouvrir le fichier pour modification tant que la transaction n’est pas validée. Par conséquent, si un thread traité ouvre le fichier en premier, tous les threads suivants qui tentent de modifier le fichier avant la validation de la transaction reçoivent une violation de partage. Si un thread non traité modifie le fichier avant le thread traité et que le fichier est toujours ouvert lorsque la transaction tente de l’ouvrir, la transaction reçoit l’erreur ERROR_TRANSACTIONAL_CONFLICT.Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Oui |
| SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO) | Oui |
| Cluster Shared Volume File System (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
Exemples
Pour obtenir un exemple, consultez Récupération et modification d’attributs de fichier.
Notes
L’en-tête fileapi.h définit SetFileAttributes comme 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
| 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] |
| Plateforme cible | Windows |
| En-tête | fileapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
Constantes d’attribut de fichier