Función GetFileAttributesTransactedW (winbase.h)

Artículo
03/13/2024

[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 mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].

Recupera los atributos del sistema de archivos de un archivo o directorio especificados como una operación de transacción.

Sintaxis

BOOL GetFileAttributesTransactedW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation,
  [in]  HANDLE                 hTransaction
);

Parámetros

[in] lpFileName

Nombre del archivo o directorio.

El archivo o directorio 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.

De forma predeterminada, el nombre está limitado 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 Nomenclatura de archivos, rutas de acceso y espacios de nombres.

Sugerencia

A partir de Windows 10, versión 1607, puede optar por quitar la limitación de MAX_PATH sin prepending "\\?\". Consulte 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.

[in] fInfoLevelId

Nivel de información de atributo que se va a recuperar.

Este parámetro puede ser el siguiente valor de la enumeración GET_FILEEX_INFO_LEVELS .

Valor	Significado
GetFileExInfoStandard	El parámetro lpFileInformation es una estructura WIN32_FILE_ATTRIBUTE_DATA .

[out] lpFileInformation

Puntero que apunta al búfer que recibe la información de atributo.

Tipo de información de atributo que se almacena en este búfer viene determinado por el valor de fInfoLevelId. Si el parámetro fInfoLevelId es GetFileExInfoStandard, este parámetro apunta a una estructura de WIN32_FILE_ATTRIBUTE_DATA

[in] hTransaction

Identificador de la transacción. La función CreateTransaction devuelve este 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 (0). Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando se llama a GetFileAttributesTransacted en un directorio que es una carpeta montada, devuelve los atributos del directorio, no los del directorio raíz del volumen que la carpeta montada asocia al directorio. Para obtener los atributos de archivo del volumen asociado, llame a GetVolumeNameForVolumeMountPoint para obtener el nombre del volumen asociado. A continuación, use el nombre resultante en una llamada a GetFileAttributesTransacted. Los resultados son los atributos del directorio raíz del volumen asociado.

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología	Compatible
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 a errores (ReFS)	No

SMB 3.0 no admite TxF.

Vínculos simbólicos: Si la ruta de acceso apunta a un vínculo simbólico, la función devuelve atributos para el vínculo simbólico.

Operaciones de transacción

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 el contrario, si un archivo está abierto para su modificación fuera de una transacción, ningún subproceso de transacción puede abrir el archivo para su modificación hasta que se cierre el identificador no transaccionado. Si un subproceso no transaccionado tiene un identificador abierto para modificar un archivo, se producirá un error de ERROR_TRANSACTIONAL_CONFLICT una llamada a GetFileAttributesTransacted para ese archivo.

Nota

El encabezado winbase.h define GetFileAttributesTransacted 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll