SetFileAttributes

9/8/2008

Essa função define os atributos de um arquivo. Uma versão RAPI dessa função existe chamado CeSetFileAttributes (RAPI).

Syntax

BOOL SetFileAttributes(
  LPCTSTR lpFileName, 
  DWORD dwFileAttributes
); 

Parameters

• lpFileName
  [no] Ponteiro para uma seqüência de caracteres que especifica o nome do arquivo cujos atributos devem ser definidas.

  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.

• dwFileAttributes
  [no] Atributos de arquivo para definir para o arquivo. Este parâmetro pode ser uma combinação de valores. No entanto, todos os outros substituir valores FILE_ATTRIBUTE_NORMAL. A seguinte tabela mostra os valores possíveis*.*

  Valor	Descrição
  FILE_ATTRIBUTE_ARCHIVE	Indica que 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_HIDDEN	Indica que o arquivo está oculto. Diretórios e arquivos ocultos não são incluídos em um listagem de diretórios típica.
  FILE_ATTRIBUTE_NORMAL	Indica que o arquivo tem há outros atributos definidos. Esse atributo é válido somente se usado sozinho.
  FILE_ATTRIBUTE_READONLY	Indica que o arquivo é 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_SYSTEM	Indica que o arquivo ou Diretório é parte de, ou será usado exclusivamente pelo, o OS.
  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.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função não trabalho sobre o ROM sistema de arquivos. Inerentemente, este chamar é dependente sobre o suporte fornecido por um driver sistema de arquivos sistema de arquivos.

O atributo FILE_ATTRIBUTE_DIRECTORY não pode ser definido usando essa função. A função CreateFile e essa função não podem ser usados para criar diretórios. Para criar um Diretório, use a função CreateDirectory.

Nem todos os sistemas arquivo suporte todos os atributos.

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
CreateDirectory
GetFileAttributes
GetFileAttributesEx