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.
Définit les attributs d’un fichier ou d’un répertoire. Le comportement de cette fonction est identique à SetFileAttributes, sauf que cette fonction respecte le modèle de sécurité des applications de 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 précéder « \\ ?\ », consultez la section « Limite maximale de longueur du chemin d’accès » de Naming Files, Path et Namespaces pour plus d’informations.
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 | Meaning |
|---|---|
| FILE_ATTRIBUTE_ARCHIVE 32 (0x20) | 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. |
| FILE_ATTRIBUTE_HIDDEN 2 (0x2) | Le fichier ou le répertoire est masqué. Il n’est pas inclus dans une liste d’annuaires ordinaire. |
| FILE_ATTRIBUTE_NORMAL 128 (0x80) | Fichier qui n’a pas d’autres attributs définis. Cet attribut est valide uniquement lorsqu’il est utilisé seul. |
| FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000) | Le fichier ou le 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 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. |
| FILE_ATTRIBUTE_READONLY 1 (0x1) | 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. |
| FILE_ATTRIBUTE_SYSTEM 4 (0x4) | Fichier ou répertoire dont le système d’exploitation utilise une partie ou utilise exclusivement. |
| FILE_ATTRIBUTE_TEMPORARY 256 (0x100) | 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. |
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’erreur étendues, appelez GetLastError.
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows 10, version 1803 |
| Header | fileapifromapp.h |
| Library | OneCore.Lib |