winbase.h


GetFileAttributesEx

[Nuevo - Windows NT]

La función GetFileAttributesEx devuelve información sobre los atributos del fichero o directorio especificado.

Esta función es similar a GetFileAttributes. GetFileAttributes devuelve un conjunto de atributos en el estilo FAT. GetFileAttributesEx está diseñada para obtener otros conjuntos de atributos de fichero o directorio. Actualmente, GetFileAttributeEx obtiene un conjunto de atributos estándar que son un superconjunto de los atributos del estilo FAT.

Sintaxis

BOOL GetFileAttributesEx(
    LPCTSTR lpFileName,                   // puntero a cadena que especifica un fichero o directorio
    GET_FILEEX_INFO_LEVELS fInfoLevelId,  // valor que especifica el tipo de información de atributos a obtener
    LPVOID lpFileInformation              // puntero al buffer que recibe la información de atributos
);

Parámetros

lpFileName: apunta a una cadena terminada en cero que especifica el nombre de un fichero o directorio.

Por defecto del tamaño de la cadena para caminos está limitada a MAX_PATH caracteres. Este límite está relacionado con el modo en que la función GetFileAttributesEx procesa los caminos. Una aplicación puede ignorar este límite y enviar caminos más largos de MAX_PATH caracteres llamando a la versión ancha (W) de GetFileAttributesEx y anteponiendo "\\?\" al camino. La cadena "\\?\" indica a la función que desconecte el análisis sintáctico del camino. Esto también funciona con nombres UNC. La cadena "\\?\" se ignora como parte del camino. Por ejemplo, "\\?\C:\myworld\private" se trata como "C:\myworld\private", y "\\?\UNC\bill_g_1\hotstuff\coolapps" como "\\bill_g_1\hotstuff\coolapps".

fInfoLevelId: valor de tipo enumerado que especifica el conjunto de atributos a obtener.

Se pueden usar los siguientes valores para fInfoLevelId:

Valor Significado
GetFileExInfoStandard La función obtiene un conjunto estándar de atributos. Los datos se devuelven en una estructura WIN32_FILE_ATTRIBUTE_DATA.

Versiones futuras de sistemas operativos basados en Win32 y otras extensiones pueden definir otros valores para el tipo enumerado GET_FILEEX_INFO_LEVELS.

lpFileInformation: puntero a un buffer que recibe la información de los atributros.

El tipo de la información de atributos almacenados en este buffer se determina mendiante el valor de fInfoLevelId, de este modo:

Valor de fInfoLevelId Estructura almacenada en *lpFileInformation
GetFileExInfoStandard WIN32_FILE_ATTRIBUTE_DATA

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener más información, llamar a GetLastError.