Función SetFileAttributesFromAppW (fileapifromapp.h)

Establece los atributos de un archivo o un directorio. El comportamiento de esta función es idéntico a SetFileAttributes, salvo que esta función se adhiere al modelo de seguridad de aplicaciones de Plataforma universal de Windows.

Sintaxis

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

Parámetros

lpFileName

Nombre del archivo cuyos atributos se van a establecer.

Para obtener información sobre cómo no participar en la limitación de MAX_PATH sin prepending "\\?\\", vea la sección "Limitación máxima de longitud de ruta de acceso" de Nombres de archivos, rutas de acceso y espacios de nombres para obtener más información.

dwFileAttributes

Atributos de archivo que se van a establecer para el archivo.

Este parámetro puede ser uno o varios valores, combinados mediante el operador OR bit a bit. Sin embargo, todos los demás valores invalidan FILE_ATTRIBUTE_NORMAL.

Esta función no admite todos los atributos.

A continuación se muestra una lista de valores de atributo admitidos.

Valor	Significado
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	Archivo o directorio que es un archivo o directorio de archivo. Las aplicaciones suelen usar este atributo para marcar los archivos de copia de seguridad o eliminación.
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	El archivo o directorio está oculto. No se incluye en ninguna lista de directorios normal.
FILE_ATTRIBUTE_NORMAL 128 (0x80)	Archivo que no tiene otros atributos establecidos. Este atributo solo es válido cuando se usa por sí solo.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	El servicio de indexación de contenido no indexa el archivo o directorio.
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	Los datos de un archivo no están disponibles inmediatamente. Este atributo indica que los datos del archivo se mueven físicamente al almacenamiento sin conexión. El almacenamiento remoto usa este atributo, que es el software de administración de almacenamiento jerárquico. Las aplicaciones no deben cambiar arbitrariamente este atributo.
FILE_ATTRIBUTE_READONLY 1 (0x1)	Archivo que es de solo lectura. Las aplicaciones pueden leer el archivo, pero no pueden escribir en él ni eliminarlo. Este atributo no se respeta en los directorios.
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	Archivo o directorio del que el sistema operativo usa parcial o exclusivamente.
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	Archivo que se usa para el almacenamiento temporal. Los sistemas de archivos evitan volver a escribir datos en almacenamiento masivo si hay suficiente memoria caché disponible, ya que una aplicación suele eliminar un archivo temporal después de cerrar el identificador. En ese escenario, el sistema puede evitar por completo la escritura de los datos. De lo contrario, los datos se escriben después de cerrar el identificador.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Cliente mínimo compatible	Windows 10, versión 1803
Encabezado	fileapifromapp.h