Compartir a través de

Función SetFileAttributesTransactedA (winbase.h)

  • Artículo

[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr a través de técnicas más sencillas y disponibles con mayor facilidad. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para obtener más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional.]

Establece los atributos de un archivo o directorio como una operación de transacción.

Sintaxis

BOOL SetFileAttributesTransactedA(
  [in] LPCSTR lpFileName,
  [in] DWORD  dwFileAttributes,
  [in] HANDLE hTransaction
);

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.

El archivo debe residir en el equipo local; De lo contrario, se produce un error en la función y el último código de error se establece en ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

[in] dwFileAttributes

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

Para obtener una lista de los valores de atributo de archivo y sus descripciones, vea Constantes de atributo de 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.

FILE_ATTRIBUTE_ARCHIVE (32 (0x20))

FILE_ATTRIBUTE_HIDDEN (2 (0x2))

FILE_ATTRIBUTE_NORMAL (128 (0x80))

FILE_ATTRIBUTE_NOT_CONTENT_INDEXED (8192 (0x2000))

FILE_ATTRIBUTE_OFFLINE (4096 (0x1000))

FILE_ATTRIBUTE_READONLY (1 (0x1))

FILE_ATTRIBUTE_SYSTEM (4 (0x4))

FILE_ATTRIBUTE_TEMPORARY (256 (0x100))

[in] hTransaction

Identificador de la transacción. El función createTransaction devuelve este identificador.

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 SetFileAttributesTransacted. Tenga en cuenta que estas no son operaciones de transacción.

Atributo Cómo establecer
FILE_ATTRIBUTE_COMPRESSED

0x800

 Para establecer el estado de compresión de un archivo, use la función deviceIoControl de con la operación de FSCTL_SET_COMPRESSION.
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 EncryptFile.
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.
 

Si un archivo está abierto para su modificación en una transacción, ningún otro subproceso puede abrir correctamente el archivo para su modificación hasta que se confirme la transacción. Si un subproceso transaccionado abre primero el archivo, los subprocesos posteriores que intenten abrir el archivo para su modificación antes de confirmar la transacción recibirán una infracción de uso compartido. Si un subproceso no transaccionado abre el archivo para su modificación antes de que lo haga el subproceso de transacción y todavía está abierto cuando el subproceso transaccionado intenta abrirlo, la transacción recibirá el error de ERROR_TRANSACTIONAL_CONFLICT.

Para obtener más información sobre las transacciones, vea ntfs transaccional.

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 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de volumen compartido de clúster (CsvFS) No
Sistema de archivos resistente (ReFS) No
 

SMB 3.0 no admite TxF.

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.

Nota

El encabezado winbase.h define SetFileAttributesTransacted 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 Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

constantes de atributo de archivo de

funciones de administración de archivos

GetFileAttributesTransacted

vínculos simbólicos

NTFS transaccional