Función GetFileAttributesExW (fileapi.h)

Artículo
02/29/2024

Recupera los atributos de un archivo o directorio especificados.

Para realizar esta operación como una operación de transacción, use la función GetFileAttributesTransact.

Sintaxis

BOOL GetFileAttributesExW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation
);

Parámetros

[in] lpFileName

Nombre del archivo o directorio.

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

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

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor 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

La función GetFileAttributes recupera información de atributo del sistema de archivos. GetFileAttributesEx puede obtener otros conjuntos de información de atributos de archivo o directorio. Actualmente, GetFileAttributesEx recupera un conjunto de atributos estándar que es un superconjunto de la información del atributo del sistema de archivos.

Cuando se llama a la función GetFileAttributesEx 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 del volumen asociado, llame a GetVolumeNameForVolumeMountPoint para obtener el nombre del volumen asociado. A continuación, use el nombre resultante en una llamada a GetFileAttributesEx. 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	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 a errores (ReFS)	Sí

Comportamiento simbólico del vínculo: 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 lo tanto, si un subproceso de transacción abre primero el archivo, cualquier subproceso posterior que intente modificar el archivo antes de que se confirme la transacción recibe 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 fileapi.h define GetFileAttributesEx 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	fileapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll