Función GetFileAttributesExA (fileapi.h)

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

Sintaxis

BOOL GetFileAttributesExA(
  [in]  LPCSTR                 lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation
);

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.

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

Valor devuelto

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

La función GetFileAttributes recupera la información de los atributos 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 de atributos del sistema de archivos.

Cuando se llama a la función getFileAttributesEx de 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 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í

 

Comportamiento de vínculo simbólico: 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 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 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 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

funciones de administración de archivos

GetFileAttributes

GetFileAttributesTransacted

SetFileAttributes

vínculos simbólicos