estructura WIN32_FIND_DATAA (minwinbase.h)

Contiene información sobre el archivo que encuentra la función FindFirstFile, FindFirstFileExo función 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 han disperso.

ftCreationTime

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

Si el sistema de archivos subyacente no admite el tiempo 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 usan 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

El DWORD de orden alto valor del tamaño de 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

El DWORD de orden bajo valor del tamaño de 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 se debe usar.

Para obtener más información, vea Etiquetas de punto de reanálisis.

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 clásico de nombre de archivo 8.3.

Observaciones

Si un archivo tiene un nombre de archivo largo, el nombre completo aparece en el miembro cFileName y aparece la versión truncada de formato 8.3 del nombre 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, consulte nombres de archivo, rutas de acceso y espacios de nombres.

No todos los sistemas de archivos pueden registrar la creación y los tiempos de último acceso, y no todos los sistemas de archivos los registran de la misma manera. 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 obtener más información, vea tiempos de archivo.

Requisitos

Consulte también

FILETIME

constantes de atributo de archivo de

nombres de archivo, rutas de acceso y espacios de nombres

tiempos de archivo

fileTimeToLocalFileTime

fileTimeToSystemTime de

FindFirstFile

FindFirstFileEx

FindNextFile

GetShortPathName