Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Define os atributos de um arquivo ou diretório. O comportamento dessa função é idêntico a SetFileAttributes, exceto que essa função adere ao modelo de segurança de aplicativo da 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 Arquivos de Nomenclatura, Caminhos e Namespaces para obter detalhes.
dwFileAttributes
Os atributos de arquivo 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.
| Value | Meaning |
|---|---|
| FILE_ATTRIBUTE_ARCHIVE 32 (0x20) | 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. |
| FILE_ATTRIBUTE_HIDDEN 2 (0x2) | O arquivo ou diretório está oculto. Ele não está incluído em uma listagem de diretório comum. |
| FILE_ATTRIBUTE_NORMAL 128 (0x80) | Um arquivo que não tem outros atributos definidos. Esse atributo é válido somente quando 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 gravá-lo ou 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 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. |
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows 10, versão 1803 |
| Header | fileapifromapp.h |
| Library | OneCore.Lib |