Función SetFileAttributesA (fileapi.h)
Establece los atributos de un archivo o directorio.
Para realizar esta operación como una operación de transacción, use la función SetFileAttributesTransacted.
Sintaxis
BOOL SetFileAttributesA(
[in] LPCSTR lpFileName,
[in] DWORD dwFileAttributes
);
Parámetros
[in] lpFileName
Nombre del archivo cuyos atributos se van a establecer.
De forma predeterminada, el nombre se limita a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, anteponga "\\?\\ " a la ruta de acceso. Para obtener más información, vea Archivos de nomenclatura, rutas de acceso y espacios de nombres.
Propina
A partir de Windows 10, versión 1607, puedes optar por quitar la limitación del MAX_PATH sin tener que prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Archivos de nomenclatura, rutas de acceso y espacios de nombres para obtener más información.
[in] 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. Para obtener más información, vea la sección Comentarios.
A continuación se muestra una lista de valores de atributo admitidos.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Observaciones
En la tabla siguiente se describe cómo establecer los atributos que no se pueden establecer mediante SetFileAttributes. Para obtener una lista completa de todos los valores de atributo de archivo y sus descripciones, vea Constantes de atributo de archivo.
| Atributo | Cómo establecer |
|---|---|
|
FILE_ATTRIBUTE_COMPRESSED
0x800 |
Para establecer el estado de compresión de un archivo, use la función deviceIoControl de |
|
FILE_ATTRIBUTE_DEVICE
0x40 |
Reservado; no use. |
|
FILE_ATTRIBUTE_DIRECTORY
0x10 |
Los archivos no se pueden convertir en directorios. Para crear un directorio, use CreateDirectory o función createDirectoryEx. |
|
FILE_ATTRIBUTE_ENCRYPTED
0x4000 |
Para crear un archivo cifrado, use la función CreateFile con el atributo FILE_ATTRIBUTE_ENCRYPTED. Para convertir un archivo existente en un archivo cifrado, use la función |
|
FILE_ATTRIBUTE_REPARSE_POINT
0x400 |
Para asociar un punto de reanálisis a un archivo o directorio, use la función DeviceIoControl con la operación de FSCTL_SET_REPARSE_POINT. |
|
FILE_ATTRIBUTE_SPARSE_FILE
0x200 |
Para establecer el atributo disperso de un archivo, use la función DeviceIoControl con la operación de FSCTL_SET_SPARSE. |
Operaciones de transacción de
Si un archivo está abierto para su modificación en una transacción, ningún otro subproceso puede abrir el archivo para su modificación hasta que se confirme la transacción. Por lo tanto, si un subproceso de transacción abre primero el archivo, los subprocesos posteriores que intenten modificar el archivo antes de confirmar la transacción reciben una infracción de uso compartido. Si un subproceso no transaccionado modifica el archivo antes de que lo haga el subproceso de transacción y el archivo sigue abierto cuando la transacción intenta abrirlo, la transacción recibe el error ERROR_TRANSACTIONAL_CONFLICT.En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Tecnología | Soportado |
|---|---|
| Protocolo bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | Sí |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Sí |
| Sistema de archivos de volumen compartido de clúster (CsvFS) | Sí |
| Sistema de archivos resistente (ReFS) | Sí |
Ejemplos
Para obtener un ejemplo, vea recuperar y cambiar atributos de archivo.
Nota
El encabezado fileapi.h define SetFileAttributes como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [aplicaciones de escritorio | Aplicaciones para UWP] |
| servidor mínimo admitido | Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP] |
| de la plataforma de destino de |
Windows |
| encabezado de |
fileapi.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |
Consulte también
constantes de atributo de archivo de