Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As constantes de atributo de arquivo definem valores de metadados armazenados pelo sistema de arquivos no disco e são usados pelo sistema e disponíveis para desenvolvedores por meio de várias APIs de E/S de arquivo. Essas constantes permitem que os desenvolvedores verifiquem e definam propriedades de arquivo, como atributos somente leitura, ocultos ou compactados. Para obter uma lista de APIs e tópicos relacionados, consulte a seção Veja também .
Example
FILE_BASIC_INFO basicInfo;
BOOL result;
result = GetFileInformationByHandleEx( hFile,
FileBasicInfo,
&basicInfo,
sizeof(basicInfo));
\\...
printf(" File Attributes: ");
PrintFileAttributes(basicInfo.FileAttributes);
\\...
VOID
PrintFileAttributes(
ULONG FileAttributes
)
{
if (FileAttributes & FILE_ATTRIBUTE_ARCHIVE) {
printf("Archive ");
}
if (FileAttributes & FILE_ATTRIBUTE_DIRECTORY) {
printf("Directory ");
}
if (FileAttributes & FILE_ATTRIBUTE_READONLY) {
printf("Read-Only ");
}
}
Exemplo obtido de um exemplo clássico do Windows no GitHub.
| Constante/valor | Description |
|---|---|
|
Um arquivo que é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravá-lo ou excluí-lo. Esse atributo não é respeitado em diretórios. |
|
O arquivo ou diretório está oculto. Ele não está incluído em uma listagem de diretório comum. |
|
Um arquivo ou diretório do qual o sistema operacional usa uma parte ou usa exclusivamente. |
|
O identificador que identifica um diretório. |
|
Um arquivo ou diretório que é um arquivo morto ou diretório. Normalmente, os aplicativos usam esse atributo para marcar arquivos para backup ou remoção. |
|
Esse valor é reservado para uso do sistema. |
|
Um arquivo que não tem outros atributos definidos. Esse atributo é válido somente quando usado sozinho. |
|
Um arquivo que está sendo usado para armazenamento temporário. Os sistemas de arquivos evitam gravar dados novamente no armazenamento em massa se a memória de cache suficiente estiver disponível, pois normalmente, um aplicativo exclui um arquivo temporário depois que o identificador é fechado. Nesse cenário, o sistema pode evitar totalmente a gravação dos dados. Caso contrário, os dados serão gravados depois que o identificador for fechado. |
|
Um arquivo que é um arquivo esparso. |
|
Um arquivo ou diretório que tem um ponto de nova análise associado ou um arquivo que é um link simbólico. |
|
Um arquivo ou diretório compactado. Para 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 recém-criados. |
|
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. |
|
O arquivo ou diretório não deve ser indexado pelo serviço de indexação de conteúdo. |
|
Um arquivo ou diretório criptografado. Para um arquivo, todos os fluxos de dados no arquivo são criptografados. Para um diretório, a criptografia é o padrão para arquivos e subdiretórios recém-criados. |
|
O diretório ou fluxo de dados do usuário é configurado com integridade (com suporte apenas em volumes ReFS). Ele não está incluído em uma listagem de diretório comum. A configuração de integridade persistirá com o arquivo se ele for renomeado. Se um arquivo for copiado, o arquivo de destino terá a integridade definida se o arquivo de origem ou o diretório de destino tiverem a integridade definida. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse sinalizador não tem suporte até o Windows Server 2012. |
|
Esse valor é reservado para uso do sistema. |
|
O fluxo de dados do usuário a não ser lido pelo verificador de integridade de dados em segundo plano (também conhecido como scrubber). Quando definido em um diretório, ele fornece apenas herança. Esse sinalizador só tem suporte em espaços de armazenamento e volumes ReFS. Ele não está incluído em uma listagem de diretório comum. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse sinalizador não tem suporte até o Windows 8 e o Windows Server 2012. |
|
Um arquivo ou diretório com atributos estendidos. IMPORTANTE: Essa constante é somente para uso interno. |
|
Esse atributo indica a intenção do usuário de que o arquivo ou diretório deve ser mantido totalmente presente localmente, mesmo quando não estiver sendo acessado ativamente. Esse atributo é usado com software de gerenciamento de armazenamento hierárquico. |
|
Esse atributo indica que o arquivo ou diretório não deve ser mantido totalmente presente localmente, exceto ao ser acessado ativamente. Esse atributo é usado com software de gerenciamento de armazenamento hierárquico. |
|
Esse atributo aparece apenas em classes de enumeração de diretório (FILE_DIRECTORY_INFORMATION, FILE_BOTH_DIR_INFORMATION etc.). Quando esse atributo é definido, significa que o arquivo ou diretório não tem representação física no sistema local; o item é virtual. Abrir o item será mais caro do que o normal, por exemplo, fará com que pelo menos parte dele seja buscado de um repositório remoto. |
|
Quando esse atributo é definido, significa que o arquivo ou diretório não está totalmente presente localmente. Para um arquivo que significa que nem todos os seus dados estão no armazenamento local (por exemplo, podem ser esparsos com alguns dados ainda no armazenamento remoto). Para um diretório, isso significa que alguns dos conteúdos do diretório estão sendo virtualizados de outro local. Ler o arquivo/enumerar o diretório será mais caro do que o normal, por exemplo, fará com que pelo menos parte do conteúdo de arquivo/diretório seja buscado de um repositório remoto. Somente chamadores do modo kernel podem definir esse bit. Os minifiltros do sistema de arquivos abaixo dos 180000 – 189999 intervalo de altitude (Grupo de Ordem de Carga do HSM FSFilter) não devem emitir leituras em cache direcionadas ou gravações em arquivos que tenham esse atributo definido. Isso pode levar à poluição do cache e à possível corrupção de arquivos. Para obter mais informações, consulte Manipulando espaços reservados. |
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Header | WinNT.h (incluir Windows.h) |