Función GetFileAttributesTransactedA (winbase.h)

Artículo
11/20/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 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.]

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

Sintaxis

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

Parámetros

[in] lpFileName

Nombre del archivo o directorio.

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 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.

[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 a un búfer que recibe la información del atributo.

El 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. 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 (0). Para obtener información de error extendida, llame a GetLastError.

Observaciones

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 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.

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 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 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, una llamada a GetFileAttributesTransacted para ese archivo producirá un error de ERROR_TRANSACTIONAL_CONFLICT.

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 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