estrutura FILE_BASIC_INFORMATION (wdm.h)

Artigo
02/27/2024

A estrutura FILE_BASIC_INFORMATION contém carimbos de data/hora e atributos básicos de um arquivo. Ele é usado como um argumento para rotinas que consultam ou definem informações de arquivo.

Sintaxe

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Membros

CreationTime

Especifica a hora em que o arquivo foi criado.

LastAccessTime

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

LastWriteTime

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

ChangeTime

Especifica a última vez em que o arquivo foi alterado.

FileAttributes

Especifica um ou mais sinalizadores FILE_ATTRIBUTE_XXX . Para obter descrições desses sinalizadores, consulte Constantes de atributo de arquivo no SDK do Microsoft Windows.

Comentários

O sinalizador FILE_ATTRIBUTE_NORMAL não pode ser definido ou retornado em combinação com outros atributos. Todos os outros valores FileAttributes substituem esse atributo.

Os valores de hora CreationTime, LastAccessTime, LastWriteTime e ChangeTime são expressos em formato de hora absoluto do sistema. A hora absoluta do sistema é o número de intervalos de 100 nanossegundos desde o início do ano 1601 no calendário gregoriano.

Se você especificar um valor zero para qualquer um dos membros XxxTime da estrutura FILE_BASIC_INFORMATION , a função ZwSetInformationFile manterá a configuração atual de um arquivo para esse período.

O sistema de arquivos atualiza os valores dos membros LastAccessTime, LastWriteTime e ChangeTime conforme apropriado depois que uma operação de E/S é executada em um arquivo. Um driver ou aplicativo pode solicitar que o sistema de arquivos não atualize um ou mais desses membros para operações de E/S executadas no identificador de arquivo do chamador definindo os membros apropriados como -1. O chamador pode definir uma, todas ou qualquer outra combinação desses três membros como -1. Somente os membros definidos como -1 não serão afetados pelas operações de E/S no identificador de arquivo; os outros membros serão atualizados conforme apropriado. Nos sistemas NTFS e ReFS, as atualizações de carimbo de data/hora no identificador de arquivo podem ser restauradas definindo os membros apropriados como -2.

Para definir os membros dessa estrutura, o chamador deve ter FILE_WRITE_ATTRIBUTES acesso ao arquivo.