GetFileAttributes
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função obtém atributos para um arquivo especificado ou Diretório. Uma versão RAPI dessa função existe chamado CeGetFileAttributes (RAPI).
Syntax
DWORD GetFileAttributes(
LPCTSTR lpFileName
);
Parameters
lpFileName
[no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o nome de um arquivo ou Diretório.O limite tamanho seqüência de caracteres usar como padrão de caminhos é caracteres MAX_PATH. Esse limite é relacionado ao como Esta função analisa os caminhos.
Return Value
Os atributos do arquivo especificado ou Diretório, retornados em uma DWORD, indicar êxito. 0xFFFFFFFF indica falha. Para informações de erro estendidas get, chamar GetLastError.
A seguinte tabela mostra os valores possíveis.
| Valor | Descrição |
|---|---|
FILE_ATTRIBUTE_ARCHIVE |
O arquivo ou Diretório é um arquivo ou Diretório. Os aplicativos usam esse atributo para arquivos marca para de backup ou remoção. |
FILE_ATTRIBUTE_COMPRESSED |
O arquivo ou Diretório está 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 |
O objeto é um Diretório. |
FILE_ATTRIBUTE_ENCRYPTED |
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 subpastas. |
FILE_ATTRIBUTE_HIDDEN |
O arquivo ou Diretório está oculto. Diretórios e arquivos ocultos não são incluídos em um listagem de diretórios típica. |
FILE_ATTRIBUTE_INROM |
Este arquivo é um arquivo OS armazenado em ROM. Esses arquivos são somente leitura e não podem ser modificados. |
FILE_ATTRIBUTE_NORMAL |
O arquivo não tem nenhum outros um conjunto de atributos. Esse atributo é válido somente se usado sozinho. |
FILE_ATTRIBUTE_READONLY |
O arquivo ou Diretório é somente leitura. Os aplicativos podem ler o arquivo, mas não é possível gravar nele ou excluí-lo. Se ele estiver um Diretório, os aplicativos não é possível excluir ou movê-lo. |
FILE_ATTRIBUTE_ROMMODULE |
Este arquivo é um arquivo OS armazenado em ROM e executar diretamente do ROM, rather than sendo primeiro copiados para memória RAM. A função CreateFile não pode ser usado para acessar este arquivo. Em vez disso, use o LoadLibrary e as funções CreateProcess. |
FILE_ATTRIBUTE_ROMSTATICREF |
O arquivo é um módulo DLL que tem uma referência implícita de at least um outro arquivo que está na seção de módulos da imagem. Um arquivo com esse atributo não pode substituir a funcionalidade do DLL com um copiar memória RAM de DLL o mesmo. Um arquivo com este atributo também deve ter a FILE_ATTRIBUTE_INROM e os atributos FILE_ATTRIBUTE_ROMMODULE. |
FILE_ATTRIBUTE_SYSTEM |
O arquivo ou Diretório é parte ou será usado exclusivamente pelo, o OS. |
FILE_ATTRIBUTE_TEMPORARY |
O arquivo está sendo usado para armazenamento temporário. Arquivo sistemas tentar manter os dados na memória para rápido acessar, rather than liberando os dados voltar para armazenamento em massa. Um arquivo temporário deve ser excluído pelo aplicativo assim ele não for mais necessária. |
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
File I/O Functions
CreateFile
FindFirstFile
SetFileAttributes
GetFileAttributesEx
GetFileInformationByHandle