estructura WIN32_FIND_DATAA (minwinbase.h)

Artículo
02/29/2024

Contiene información sobre el archivo que encuentran las funciones FindFirstFile, FindFirstFileEx o FindNextFile.

Sintaxis

typedef struct _WIN32_FIND_DATAA {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  CHAR     cFileName[MAX_PATH];
  CHAR     cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;

Miembros

dwFileAttributes

Atributos de archivo de un archivo.

Para conocer los valores posibles y sus descripciones, vea Constantes de atributo de archivo.

El atributo FILE_ATTRIBUTE_SPARSE_FILE en el archivo se establece si alguna de las secuencias del archivo alguna vez se ha disperso.

ftCreationTime

Estructura FILETIME que especifica cuándo se creó un archivo o directorio.

Si el sistema de archivos subyacente no admite la hora de creación, este miembro es cero.

ftLastAccessTime

Estructura FILETIME .

Para un archivo, la estructura especifica cuándo se leyó por última vez el archivo, se escribió en o para los archivos ejecutables, se ejecuta.

Para un directorio, la estructura especifica cuándo se crea el directorio. Si el sistema de archivos subyacente no admite la hora de último acceso, este miembro es cero.

En el sistema de archivos FAT, la fecha especificada para los archivos y directorios es correcta, pero la hora del día siempre se establece en medianoche.

ftLastWriteTime

Estructura FILETIME .

Para un archivo, la estructura especifica cuándo se escribió por última vez el archivo en, truncado o sobrescrito, por ejemplo, cuando se usa WriteFile o SetEndOfFile . La fecha y hora no se actualizan cuando se cambian los atributos de archivo o los descriptores de seguridad.

Para un directorio, la estructura especifica cuándo se crea el directorio. Si el sistema de archivos subyacente no admite la hora de última escritura, este miembro es cero.

nFileSizeHigh

Valor DWORD de orden alto del tamaño del archivo, en bytes.

Este valor es cero a menos que el tamaño del archivo sea mayor que MAXDWORD.

El tamaño del archivo es igual a (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow.

nFileSizeLow

Valor DWORD de orden bajo del tamaño del archivo, en bytes.

dwReserved0

Si el miembro dwFileAttributes incluye el atributo FILE_ATTRIBUTE_REPARSE_POINT , este miembro especifica la etiqueta de punto de reanálisis.

De lo contrario, este valor no está definido y no debe usarse.

Para obtener más información, vea Reanálisis de etiquetas de punto.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_SYMLINK (0xA000000C)

IO_REPARSE_TAG_WIM (0x80000008)

dwReserved1

Reservado para uso futuro.

cFileName[MAX_PATH]

Nombre del archivo.

cAlternateFileName[14]

Un nombre alternativo para el archivo.

Este nombre está en el formato de nombre de archivo clásico 8.3.

Comentarios

Si un archivo tiene un nombre de archivo largo, el nombre completo aparece en el miembro cFileName y la versión truncada de formato 8.3 del nombre aparece en el miembro cAlternateFileName . De lo contrario, cAlternateFileName está vacío. Si se llamó a la función FindFirstFileEx con un valor de FindExInfoBasic en el parámetro fInfoLevelId , el miembro cAlternateFileName siempre contendrá un valor de cadena NULL . Esto sigue siendo true para todas las llamadas posteriores a la función FindNextFile . Como método alternativo para recuperar la versión de formato 8.3 de un nombre de archivo, puede usar la función GetShortPathName . Para obtener más información sobre los nombres de archivo, vea Nombres de archivo , rutas de acceso y espacios de nombres.

No todos los sistemas de archivos pueden registrar la creación y la hora de último acceso y no todos los sistemas de archivos los registran de la misma forma. Por ejemplo, en el sistema de archivos FAT, el tiempo de creación tiene una resolución de 10 milisegundos, el tiempo de escritura tiene una resolución de 2 segundos y el tiempo de acceso tiene una resolución de 1 día. El sistema de archivos NTFS retrasa las actualizaciones de la última hora de acceso de un archivo hasta 1 hora después del último acceso. Para más información, consulte Tiempos de archivo.

Nota

El encabezado minwinbase.h define WIN32_FIND_DATA como un 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]
Encabezado	minwinbase.h (incluya Windows.h)