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
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.
Nota
El encabezado minwinbase.h define WIN32_FIND_DATA 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] |
| encabezado de |
minwinbase.h (incluya Windows.h) |
Consulte también
constantes de atributo de archivo de
nombres de archivo, rutas de acceso y espacios de nombres
fileTimeToSystemTime de