estructura FILE_FULL_DIR_INFO (winbase.h)

  • Artículo

Contiene la información del directorio de un archivo. Esta estructura se devuelve de la función GetFileInformationByHandleEx cuando FileFullDirectoryInfo o FileFullDirectoryRestartInfo se pasa en el parámetro FileInformationClass .

Sintaxis

typedef struct _FILE_FULL_DIR_INFO {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  ULONG         EaSize;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

Miembros

NextEntryOffset

Desplazamiento de la siguiente estructura FILE_FULL_DIR_INFO que se devuelve. Contiene cero (0) si ninguna otra entrada sigue esta.

FileIndex

Desplazamiento de bytes del archivo dentro del directorio primario. Este miembro no está definido para los sistemas de archivos, como NTFS, en los que la posición de un archivo dentro del directorio primario no es fija y se puede cambiar en cualquier momento para mantener el criterio de ordenación.

CreationTime

Hora en que se creó el archivo.

LastAccessTime

Hora a la que se accedió por última vez al archivo.

LastWriteTime

Hora en la que se escribió por última vez el archivo.

ChangeTime

Hora en que se cambió el archivo por última vez.

EndOfFile

Posición absoluta del final del archivo como desplazamiento de bytes desde el inicio del archivo hasta el final del flujo de datos predeterminado del archivo. Dado que este valor se basa en cero, realmente hace referencia al primer byte libre del archivo. En otras palabras, EndOfFile es el desplazamiento al byte que sigue inmediatamente al último byte válido del archivo.

AllocationSize

Número de bytes asignados para el archivo. Este valor suele ser un múltiplo del tamaño del sector o clúster del dispositivo físico subyacente.

FileAttributes

Atributos de archivo. Este miembro puede ser cualquier combinación válida de los siguientes atributos:

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

Longitud del nombre de archivo.

EaSize

Tamaño de los atributos extendidos para el archivo.

FileName[1]

Primer carácter de la cadena de nombre de archivo. Esto va seguido en memoria por el resto de la cadena.

Comentarios

La estructura FILE_FULL_DIR_INFO es un subconjunto de la información de la estructura FILE_ID_BOTH_DIR_INFO . Si no se necesita la información adicional, la operación será más rápida, ya que procede de la entrada del directorio; FILE_ID_BOTH_DIR_INFO contiene información de la entrada de directorio y de la tabla de archivos maestros (MFT).

No se requieren derechos de acceso específicos para consultar esta información.

Todas las fechas y horas están en formato absoluto de tiempo del sistema. La hora absoluta del sistema es el número de intervalos de 100 nanosegundos desde el inicio del año 1601.

Esta estructura FILE_FULL_DIR_INFO debe alinearse en un límite de LONGLONG (8 bytes). Si un búfer contiene dos o más de estas estructuras, el valor NextEntryOffset de cada entrada, excepto el último, cae en un límite de 8 bytes.

Para compilar una aplicación que use esta estructura, defina la macro _WIN32_WINNT como 0x0600 o posterior. Para obtener más información, vea Uso de los encabezados de Windows.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado winbase.h (incluya Windows.h)

Consulte también

FILE_INFO_BY_HANDLE_CLASS

Estructuras de administración de archivos

GetFileInformationByHandleEx