estrutura FILE_ID_EXTD_DIR_INFO (winbase.h)

Contém informações de identificação de um arquivo. Essa estrutura é retornada da função GetFileInformationByHandleEx quando FileIdExtdDirectoryInfo (0x13) ou FileIdExtdDirectoryRestartInfo (0x14) é passado no parâmetro FileInformationClass .

Sintaxe

typedef struct _FILE_ID_EXTD_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;
  ULONG         ReparsePointTag;
  FILE_ID_128   FileId;
  WCHAR         FileName[1];
} FILE_ID_EXTD_DIR_INFO, *PFILE_ID_EXTD_DIR_INFO;

Membros

NextEntryOffset

O deslocamento para a próxima estrutura de FILE_ID_EXTD_DIR_INFO 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 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:

Valor Significado
FILE_ATTRIBUTE_ARCHIVE
32 (0x20)
Um arquivo ou diretório que é um arquivo morto ou diretório. Os aplicativos normalmente usam esse atributo para marcar arquivos para backup ou remoção. 
FILE_ATTRIBUTE_COMPRESSED
2048 (0x800)
Um arquivo ou diretório que está compactado. Em um arquivo, todos os dados no arquivo são compactados. Para um diretório, a compactação é o padrão para arquivos e subdiretórios que acabam de ser criados.
FILE_ATTRIBUTE_DEVICE
64 (0x40)
Esse valor é reservado para uso do sistema.
FILE_ATTRIBUTE_DIRECTORY
16 (0x10)
O identificador que identifica um diretório.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x4000)
Um arquivo ou diretório que está criptografado. Em um arquivo, todos os fluxos de dados no arquivo são criptografados. Em um diretório, a criptografia é o padrão para arquivos e subdiretórios que acabam de ser criados.
FILE_ATTRIBUTE_HIDDEN
2 (0x2)
O arquivo ou diretório está oculto. Ele não está incluído em uma listagem de diretórios comuns.
FILE_ATTRIBUTE_NORMAL
128 (0x80)
Um arquivo que não tem outros atributos definidos. Este atributo é válido somente quando for usado sozinho.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
8192 (0x2000)
O arquivo ou diretório não deve ser indexado pelo serviço de indexação de conteúdo.
FILE_ATTRIBUTE_OFFLINE
4096 (0x1000)
Os dados de um arquivo não estão disponíveis imediatamente. Esse atributo indica que os dados do arquivo são movidos fisicamente para o armazenamento offline. Esse atributo é usado pelo armazenamento remoto, que é o software de gerenciamento de armazenamento hierárquico. Os aplicativos não devem alterar esse atributo arbitrariamente.
FILE_ATTRIBUTE_READONLY
1 (0x1)
Um arquivo que é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravar nele nem excluí-lo. Esse atributo não é respeitado em diretórios. Para obter mais informações, consulte Não é possível exibir ou alterar os atributos Somente leitura ou Sistema de pastas no Windows Server 2003, no Windows XP, no Windows Vista ou no Windows 7.
FILE_ATTRIBUTE_REPARSE_POINT
1024 (0x400)
Um arquivo ou diretório que tem um ponto de nova análise associado ou um arquivo que é um link simbólico.
FILE_ATTRIBUTE_SPARSE_FILE
512 (0x200)
Um arquivo que é um arquivo esparso.
FILE_ATTRIBUTE_SYSTEM
4 (0x4)
Um arquivo ou diretório do qual o sistema operacional usa uma parte ou usa exclusivamente.
FILE_ATTRIBUTE_TEMPORARY
256 (0x100)
Um arquivo que está sendo usado para armazenamento temporário. Os sistemas de arquivos evitam gravar dados de volta no armazenamento em massa se houver memória de cache suficiente disponível, pois, normalmente, um aplicativo exclui um arquivo temporário depois que o identificador é fechado. Nesse cenário, o sistema pode evitar totalmente gravar os dados. Caso contrário, os dados serão gravados depois que o identificador for fechado.
FILE_ATTRIBUTE_VIRTUAL
65536 (0x10000)
Esse valor é reservado para uso do sistema.

FileNameLength

O comprimento do nome do arquivo.

EaSize

O tamanho dos atributos estendidos para o arquivo.

ReparsePointTag

Se o membro FileAttributes incluir o atributo FILE_ATTRIBUTE_REPARSE_POINT , esse membro especificará a marca de ponto de nova análise.

Caso contrário, esse valor é indefinido e não deve ser usado.

Para obter mais informações, consulte Reparse Point Tags.

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)

FileId

A ID do 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho winbase.h (inclua Windows.h)

Confira também

FILE_ID_128

FILE_INFO_BY_HANDLE_CLASS

Estruturas de gerenciamento de arquivos

GetFileInformationByHandleEx