Share via

enumeração KNOWN_FOLDER_FLAG (shlobj_core.h)

  • Artigo

Define constantes que especificam opções de recuperação especiais para pastas conhecidas (por exemplo, para uso ao chamar a função SHGetKnownFolderIDList para recuperar o caminho de uma pasta conhecida). Esses valores substituem valores CSIDL , que têm significados paralelos.

Syntax

typedef enum {
  KF_FLAG_DEFAULT = 0x00000000,
  KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x00080000,
  KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x00040000,
  KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x00020000,
  KF_FLAG_NO_PACKAGE_REDIRECTION = 0x00010000,
  KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x00020000,
  KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x00010000,
  KF_FLAG_CREATE = 0x00008000,
  KF_FLAG_DONT_VERIFY = 0x00004000,
  KF_FLAG_DONT_UNEXPAND = 0x00002000,
  KF_FLAG_NO_ALIAS = 0x00001000,
  KF_FLAG_INIT = 0x00000800,
  KF_FLAG_DEFAULT_PATH = 0x00000400,
  KF_FLAG_NOT_PARENT_RELATIVE = 0x00000200,
  KF_FLAG_SIMPLE_IDLIST = 0x00000100,
  KF_FLAG_ALIAS_ONLY = 0x80000000
} KNOWN_FOLDER_FLAG;

Constantes

 
KF_FLAG_DEFAULT
Valor: 0x00000000
Não especifica nenhuma opção de recuperação especial.
KF_FLAG_FORCE_APP_DATA_REDIRECTION
Valor: 0x00080000
Introduzido no Windows 10, versão 1709. Quando chamado de um aplicativo empacotado, especifica que as pastas LocalAppData/RoamingAppData são redirecionadas para locais de aplicativo privado que correspondem aos caminhos retornados de Windows.Storage.ApplicationData.Current nas propriedades LocalFolder e RoamingFolder . Outras pastas são redirecionadas para subdiretórios de LocalAppData.

Esse sinalizador é usado com FOLDERID_AppDataDesktop, FOLDERID_AppDataDocuments, FOLDERID_AppDataFavorites e FOLDERID_AppDataProgramData. Ele também se destina à compatibilidade com aplicativos .NET e não deve ser usado diretamente de um aplicativo.
KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET
Valor: 0x00040000
Introduzido no Windows 10, versão 1703. Ao executar em um processo empacotado, especifica que alguns locais do sistema de arquivos são redirecionados para locais específicos do pacote pelo sistema de arquivos. Esse sinalizador faz com que o destino da direção seja retornado para esses locais. Isso é útil nos casos em que o local real dentro do sistema de arquivos precisa ser conhecido.
KF_FLAG_FORCE_PACKAGE_REDIRECTION
Valor: 0x00020000
Introduzido no Windows 10, versão 1703. Ao executar dentro de um processo AppContainer ou ao fornecer um token AppContainer, especifica que algumas pastas são redirecionadas para locais específicos do AppContainer dentro do pacote. Esse sinalizador força o redirecionamento (para pastas que normalmente não são redirecionadas) para fins de processos empacotados e pode ser usado para compartilhar arquivos entre UWP e aplicativos empacotados dentro do mesmo pacote. Esse sinalizador substitui o KF_FLAG_FORCE_APPCONTAINER_REDIRECTION preterido.
KF_FLAG_NO_PACKAGE_REDIRECTION
Valor: 0x00010000
Introduzido no Windows 10, versão 1703. Ao executar dentro de um processo empacotado ou ao fornecer um token de processo empacotado, especifica que algumas pastas são redirecionadas para locais específicos do pacote. Esse sinalizador desabilita o redirecionamento em locais em que ele é aplicado e, em vez disso, retorna o caminho que seria retornado se ele não estivesse em execução dentro de um processo empacotado. Esse sinalizador substitui a KF_FLAG_NO_APPCONTAINER_REDIRECTION preterida.
KF_FLAG_FORCE_APPCONTAINER_REDIRECTION
Valor: 0x00020000
Introduzido em Windows 8. Esse sinalizador foi preterido no Windows 10, versão 1703. Em vez disso , use KF_FLAG_FORCE_PACKAGE_REDIRECTION .
KF_FLAG_NO_APPCONTAINER_REDIRECTION
Valor: 0x00010000
Introduzido em Windows 8. Esse sinalizador foi preterido no Windows 10, versão 1703. Em vez disso , use KF_FLAG_NO_PACKAGE_REDIRECTION .
KF_FLAG_CREATE
Valor: 0x00008000
Especifica para forçar a criação da pasta especificada se essa pasta ainda não existir. As provisões de segurança predefinidas para essa pasta são aplicadas. Se a pasta não existir e não puder ser criada, a função retornará um código de falha e nenhum caminho será retornado. Esse valor só pode ser usado com as seguintes funções e métodos:

* SHGetKnownFolderPath
* SHGetKnownFolderIDList
* IKnownFolder::GetIDList
* IKnownFolder::GetPath
* IKnownFolder::GetShellItem
KF_FLAG_DONT_VERIFY
Valor: 0x00004000
Especifica não verificar a existência da pasta antes de tentar recuperar o caminho ou IDList. Se esse sinalizador não estiver definido, será feita uma tentativa de verificar se a pasta está realmente presente no caminho. Se essa verificação falhar devido à ausência ou inacessível da pasta, a função retornará um código de falha e nenhum caminho será retornado.

Se a pasta estiver localizada em uma rede, a função poderá levar mais tempo para ser executada. Portanto, definir esse sinalizador pode reduzir essa latência.
KF_FLAG_DONT_UNEXPAND
Valor: 0x00002000
Especifica para armazenar o caminho completo no Registro sem usar cadeias de caracteres de ambiente. Se esse sinalizador não estiver definido, partes do caminho poderão ser representadas por cadeias de caracteres de ambiente, como %USERPROFILE%. Esse sinalizador só pode ser usado com SHSetKnownFolderPath e IKnownFolder::SetPath.
KF_FLAG_NO_ALIAS
Valor: 0x00001000
Especifica a recuperação do caminho do sistema verdadeiro para a pasta, livre de espaços reservados alias, como %USERPROFILE%, retornado por SHGetKnownFolderIDList e IKnownFolder::GetIDList. Esse sinalizador não tem efeito nos caminhos retornados por SHGetKnownFolderPath e IKnownFolder::GetPath. Por padrão, funções e métodos conhecidos de recuperação de pasta retornam o caminho aliased se houver um alias.
KF_FLAG_INIT
Valor: 0x00000800
Especifica para inicializar a pasta usando suas Desktop.ini configurações. Se a pasta não puder ser inicializada, a função retornará um código de falha e nenhum caminho será retornado. Esse sinalizador sempre deve ser combinado com KF_FLAG_CREATE.

Se a pasta estiver localizada em uma rede, a função poderá levar mais tempo para ser executada.
KF_FLAG_DEFAULT_PATH
Valor: 0x00000400
Especifica para recuperar o caminho padrão para uma pasta conhecida. Se esse sinalizador não estiver definido, a função recuperará o caminho atual e possivelmente redirecionado da pasta. A execução desse sinalizador inclui uma verificação da existência da pasta, a menos que KF_FLAG_DONT_VERIFY esteja definido.
KF_FLAG_NOT_PARENT_RELATIVE
Valor: 0x00000200
Especifica para recuperar o caminho padrão da pasta independentemente do local atual de seu pai. KF_FLAG_DEFAULT_PATH também deve ser definido.
KF_FLAG_SIMPLE_IDLIST
Valor: 0x00000100
Especifica a criação de uma PIDL (IDList simples). Esse valor pode ser usado quando você deseja recuperar o caminho do sistema de arquivos. Mas não especifique esse valor se você estiver recuperando o nome de exibição localizado da pasta, pois ele pode não resolve corretamente.
KF_FLAG_ALIAS_ONLY
Valor: 0x80000000
Introduzido no Windows 7. Especifica para recuperar apenas PIDLs aliased. Não use o caminho do sistema de arquivos.

Comentários

Esses valores, com exceção de KF_FLAG_ALIAS_ONLY, foram definidos no Windows Vista como constantes individuais. Eles são definidos como uma enumeração somente no Windows 7 e posterior. No entanto, todos os valores numéricos subjacentes são os mesmos em ambos os formulários.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho shlobj_core.h (inclua Shlobj.h)

Confira também