Função SetFileAttributesFromAppW (fileapifromapp.h)

Define os atributos de um arquivo ou diretório. O comportamento dessa função é idêntico a SetFileAttributes, exceto que essa função segue o modelo de segurança do aplicativo Plataforma Universal do Windows.

Sintaxe

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

Parâmetros

lpFileName

O nome do arquivo cujos atributos devem ser definidos.

Para obter informações sobre como recusar a limitação de MAX_PATH sem acrescentar "\\?\", consulte a seção "Limitação máxima do comprimento do caminho" de Nomear arquivos, caminhos e namespaces para obter detalhes.

dwFileAttributes

Os atributos a serem definidos para o arquivo.

Esse parâmetro pode ser um ou mais valores, combinados usando o operador OR bit a bit. No entanto, todos os outros valores substituem FILE_ATTRIBUTE_NORMAL.

Nem todos os atributos têm suporte nessa função.

Veja a seguir uma lista de valores de atributo com suporte.

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_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.
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.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Cliente mínimo com suporte	Windows 10, versão 1803
Cabeçalho	fileapifromapp.h