BY_HANDLE_FILE_INFORMATION

9/8/2008

Essa estrutura contém informações obtidas pela função GetFileInformationByHandle.

Syntax

typedef struct _BY_HANDLE_FILE_INFORMATION { 
  DWORD dwFileAttributes; 
  FILETIME ftCreationTime; 
  FILETIME ftLastAccessTime; 
  FILETIME ftLastWriteTime; 
  DWORD dwVolumeSerialNumber; 
  DWORD nFileSizeHigh; 
  DWORD nFileSizeLow; 
  DWORD nNumberOfLinks; 
  DWORD nFileIndexHigh; 
  DWORD nFileIndexLow;
  DWORD dwOID;
} BY_HANDLE_FILE_INFORMATION; 

Os membros

• dwFileAttributes
  Atributos de arquivo. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  FILE_ATTRIBUTE_ARCHIVE	Indica que o arquivo ou Diretório é um arquivo. Os aplicativos usam esse atributo para arquivos marca para de backup ou remoção.
  FILE_ATTRIBUTE_COMPRESSED	Indica que o arquivo ou Diretório é compactado. Para um arquivo, isso significa que todos os dados no arquivo é compactado. Para um Diretório, isso significa que compactação é o usar como padrão para arquivos recém-criados e subpastas.
  FILE_ATTRIBUTE_DIRECTORY	Indica que o identificador identifica um Diretório.
  FILE_ATTRIBUTE_ENCRYPTED	Indica que o arquivo ou Diretório está criptografado. Para um arquivo, isso significa que todos os fluxos dados são criptografados. Para um Diretório, isso significa que criptografia é o usar como padrão para arquivos recém-criados e diretórios.
  FILE_ATTRIBUTE_HIDDEN	Indica que o arquivo ou Diretório está oculto. Ele não está incluído em um listagem de diretórios comum.
  FILE_ATTRIBUTE_INROM	Indica que o arquivo é um arquivo sistema operacional armazenado em ROM. Esses arquivos são somente leitura. Eles não podem ser modificados.
  FILE_ATTRIBUTE_NORMAL	Indica que o arquivo tem há outros atributos. Esse atributo é válido somente se usado sozinho.
  FILE_ATTRIBUTE_READONLY	Indica que o arquivo ou Diretório é somente leitura. Os aplicativos podem ler o arquivo, mas não é possível gravar nele ou excluí-lo. Na maiúsculas e minúsculas de um Diretório, os aplicativos não é possível excluí-la.
  FILE_ATTRIBUTE_REPARSE_POINT	Indica que o arquivo tem um associado apontar reanalisar.
  FILE_ATTRIBUTE_ROMMODULE	Indica que esse arquivo é um arquivo sistema operacional armazenado em ROM, projetado para executar no local. Em outras palavras, codificar desse arquivo vai diretamente de ROM, em vez pela primeira vez que está sendo copiado para memória RAM. A função CreateFile não pode ser usado para acessar este arquivo. Em vez disso, a LoadLibrary e as funções CreateProcess devem ser usadas.
  FILE_ATTRIBUTE_ROMSTATICREF	Indica que o módulo DLL implicitamente está vinculado para outro módulo na ROM sistema de arquivos. Isso impede que o módulo DLL que está sendo substituída por uma versão memória RAM da DLL.
  FILE_ATTRIBUTE_SPARSE_FILE	Indica que o arquivo é um arquivo esparso.
  FILE_ATTRIBUTE_SYSTEM	Indica que o arquivo ou Diretório é parte de sistema operacional ou será usado exclusivamente pelo sistema operacional.
  FILE_ATTRIBUTE_TEMPORARY	Indica que o arquivo está sendo usado para armazenamento temporário. Arquivo sistemas tentar manter todos os dados na memória para rápido acessar, rather than liberando os dados voltar para armazenamento em massa. Um arquivo temporário devem ser excluídos, assim ele não for mais necessária.

• ftCreationTime
  Horário em que o arquivo foi criado. Se o subjacente sistema de arquivos não suporte este membro, ela é definida como zero.

• ftLastAccessTime
  Hora em que o arquivo foi acessado pela última vez. Se o subjacente sistema de arquivos não suporte este membro, ela é definida como zero.

• ftLastWriteTime
  Último tempo o arquivo foi gravado para.

• dwVolumeSerialNumber
  Número serial do volume que contém o arquivo.

• nFileSizeHigh
  Alto-palavra ordem de tamanho de arquivo.

• nFileSizeLow
  Baixo-palavra ordem de tamanho de arquivo.

• nNumberOfLinks
  Número de links para este arquivo. Para o FAT sistema de arquivos, esse membro é sempre definido como 1.

• nFileIndexHigh
  Alto-ordem palavra de uma identificador exclusivo associado com o arquivo.

• nFileIndexLow
  Baixo-ordem palavra de uma identificador exclusivo associado com o arquivo. Esse identificador e o volume serial número identificam um arquivo. Esse número pode alteração quando o sistema for reiniciado ou quando o arquivo é aberto. Após um processo abre um arquivo, o identificador é constante até que o arquivo é fechado. Um aplicativo pode usar este identificador e o volume serial número para determinar se dois manipula referir para o mesmo arquivo.

• dwOID
  Identificador de objeto (OID) do arquivo. Este parâmetro é válido somente em arquivos que são armazenados em armazenar o objeto. Arquivos em sistemas arquivo externo não tem identificadores objeto associado com eles.

  Observação

  Windows CE 2.12 e anteriormente atribuídas OIDs a objetos em outros sistemas, such as o FAT arquivo sistema de arquivos.Esses OIDs foram garantia ser exclusivo em um volume, mas não entre múltiplo volumes.Eficaz com Windows CE 3.0, os objetos somente arquivo e Diretório que possuem válido, exclusivo OIDs são em armazenar o objeto.Objetos de banco de dados, em qualquer sistema de arquivos, têm válido, exclusivo OIDs.

Remarks

Nem todos os sistemas arquivo podem criação registro última horário do acesso e nem todos os arquivo sistemas registro-las da mesma maneira. De exemplo, o objeto armazenar memória RAM sistema de arquivos mantém apenas o último tempo modificado.

Requirements

Header	winbase.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Structures
GetFileInformationByHandle

Other Resources

FILETIME