estrutura FILE_FULL_DIR_INFO (winbase.h)

Contém informações de diretório de um arquivo. Essa estrutura é retornada da função GetFileInformationByHandleEx quando FileFullDirectoryInfo ou FileFullDirectoryRestartInfo é passado no parâmetro FileInformationClass .

Sintaxe

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;

Membros

NextEntryOffset

O deslocamento para o próximo FILE_FULL_DIR_INFO estrutura retornada. Contém zero (0) se nenhuma outra entrada seguir esta.

FileIndex

O deslocamento de bytes do arquivo no diretório pai. Esse membro é indefinido para sistemas de arquivos, como o NTFS, no qual a posição de um arquivo dentro do diretório pai não é fixa e pode ser alterada a qualquer momento para manter a ordem de classificação.

CreationTime

A hora em que o arquivo foi criado.

LastAccessTime

A hora em que o arquivo foi acessado pela última vez.

LastWriteTime

A hora em que o arquivo foi gravado pela última vez.

ChangeTime

A hora em que o arquivo foi alterado pela última vez.

EndOfFile

A nova posição absoluta do fim do arquivo como um deslocamento de bytes do início do arquivo até o final do fluxo de dados padrão do arquivo. Como esse valor é baseado em zero, ele realmente se refere ao primeiro byte gratuito no arquivo. Em outras palavras, EndOfFile é o deslocamento para o byte que segue imediatamente o último byte válido no arquivo.

AllocationSize

O número de bytes alocados para o arquivo. Esse valor geralmente é um múltiplo do setor ou do tamanho do cluster do dispositivo físico subjacente.

FileAttributes

Os atributos de arquivo. Esse membro pode ser qualquer combinação válida dos seguintes 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

O comprimento do nome do arquivo.

EaSize

O tamanho dos atributos estendidos para o arquivo.

FileName[1]

O primeiro caractere da cadeia de caracteres de nome de arquivo. Isso é seguido na memória pelo restante da cadeia de caracteres.

Comentários

A estrutura FILE_FULL_DIR_INFO é um subconjunto das informações na estrutura FILE_ID_BOTH_DIR_INFO . Se as informações adicionais não forem necessárias, a operação será mais rápida, pois ela vem da entrada do diretório; FILE_ID_BOTH_DIR_INFO contém informações da entrada do diretório e da MFT (Tabela de Arquivos Mestre).

Nenhum direito de acesso específico é necessário para consultar essas informações.

Todas as datas e horas estão em formato absoluto de hora do sistema. O tempo absoluto do sistema é o número de intervalos de 100 nanossegundos desde o início do ano de 1601.

Essa estrutura FILE_FULL_DIR_INFO deve ser alinhada em um limite LONGLONG (8 bytes). Se um buffer contiver duas ou mais dessas estruturas, o valor NextEntryOffset em cada entrada, exceto o último, cairá em um limite de 8 bytes.

Para compilar um aplicativo que usa essa estrutura, defina a macro _WIN32_WINNT como 0x0600 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos

Confira também

FILE_INFO_BY_HANDLE_CLASS

Estruturas de gerenciamento de arquivos

GetFileInformationByHandleEx