estructura WIN32_FIND_DATAW (minwinbase.h)

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

Sintaxis

typedef struct _WIN32_FIND_DATAW {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    dwReserved0;
  DWORD    dwReserved1;
  WCHAR    cFileName[MAX_PATH];
  WCHAR    cAlternateFileName[14];
  DWORD    dwFileType; // Obsolete. Do not use.
  DWORD    dwCreatorType; // Obsolete. Do not use
  WORD     wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAW, *PWIN32_FIND_DATAW, *LPWIN32_FIND_DATAW;

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 se ha disperso alguna vez.

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

Una 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

Una 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 superior 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 se debe usar.

Para obtener más información, vea Reparse point Tags (Volver a analizar 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_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 con 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 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 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 (incluye Windows.h)

Consulte también

FILETIME

Constantes de atributo de archivo

Nombres de archivo, rutas de acceso y espacios de nombres

Tiempos de archivo

FileTimeToLocalFileTime

FileTimeToSystemTime

FindFirstFile

FindFirstFileEx

FindNextFile

GetShortPathName