SetFileAttributesFromAppW, fonction (fileapifromapp.h)

Définit les attributs d’un fichier ou d’un répertoire. Le comportement de cette fonction est identique à SetFileAttributes, à ceci près que cette fonction adhère au modèle de sécurité d’application plateforme Windows universelle.

Syntaxe

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

Paramètres

lpFileName

Nom du fichier dont les attributs doivent être définis.

Pour plus d’informations sur la désactivation de la limitation de MAX_PATH sans passer à la limite « \??\ », consultez la section « Limitation de longueur maximale du chemin d’accès » de l’article Nommage des fichiers, des chemins et des espaces de noms .

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.

Voici une liste des valeurs d’attribut prises en charge.

Valeur	Signification
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	Fichier ou répertoire qui correspond à un fichier ou répertoire d’archive. Les applications utilisent généralement cet attribut pour marquer les fichiers à des fins de sauvegarde ou de suppression.
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	Le fichier ou répertoire est masqué. Il n’est pas inclus dans une liste de répertoires classique.
FILE_ATTRIBUTE_NORMAL 128 (0x80)	Fichier qui n’a pas d’autres attributs définis. Cet attribut est uniquement valide quand il est utilisé seul.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	Le fichier ou répertoire ne doit pas être indexé par le service d’indexation de contenu.
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	Les données d’un fichier ne sont pas disponibles immédiatement. Cet attribut indique que les données du fichier sont physiquement déplacées vers le stockage hors connexion. Cet attribut est utilisé par Stockage étendu, qui est le logiciel de gestion du stockage hiérarchique. Les applications ne doivent pas modifier arbitrairement cet attribut.
FILE_ATTRIBUTE_READONLY 1 (0x1)	Fichier en lecture seule. Les applications peuvent lire le fichier, mais elles ne peuvent pas y écrire ni le supprimer. Cet attribut n’est pas honoré sur des répertoires.
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	Fichier ou répertoire dont le système d’exploitation utilise une partie ou qu’il utilise exclusivement.
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	Fichier utilisé pour le stockage temporaire. Les systèmes de fichiers évitent de récrire des données dans le stockage de masse si la mémoire cache disponible est suffisante, car en général, une application supprime un fichier temporaire une fois le descripteur fermé. Dans ce scénario, le système peut entièrement éviter d’écrire les données. Sinon, les données sont écrites après la fermeture du descripteur.

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.

Configuration requise

Client minimal pris en charge	Windows 10 version 1803
En-tête	fileapifromapp.h