SFGAO
SFGAO Os valores de bitfield representam atributos que podem ser recuperados em um item (arquivo ou pasta) ou conjunto de itens. Eles são usados com as APIs IShellFolder e IShellItem, principalmente IShellFolder::GetAttributesOf e IShellItem::GetAttributes.
| Constante/valor | Descrição |
|---|---|
|
Os itens especificados podem ser copiados. |
|
Os itens especificados podem ser movidos. |
|
Atalhos podem ser criados para os itens especificados. Esse atributo tem o mesmo valor que DROPEFFECT_LINK. Se uma extensão de namespace retornar esse atributo, uma entrada Criar Atalho com um manipulador padrão será adicionada ao menu de atalho exibido durante operações de arrastar e soltar. A extensão também pode implementar seu próprio manipulador para o verbo de link no lugar do padrão. Se a extensão fizer isso, ela será responsável por criar o atalho. Um item Criar Atalho também é adicionado ao menu Arquivo Explorer do Windows e aos menus de atalho normais. Se o item estiver selecionado, o método IContextMenu::InvokeCommand do aplicativo será invocado com o membro lpVerb da estrutura CMINVOKECOMMANDINFO definida como link. Seu aplicativo é responsável por criar o link. |
|
Os itens especificados podem ser associados a um objeto IStorage por meio de IShellFolder::BindToObject. Para obter mais informações sobre os recursos de manipulação de namespace, consulte IStorage. |
|
Os itens especificados podem ser renomeados. Observe que esse valor é essencialmente uma sugestão; nem todos os clientes de namespace permitem que os itens sejam renomeado. No entanto, aqueles que o fazem devem ter esse atributo definido. |
|
Os itens especificados podem ser excluídos. |
|
Os itens especificados têm folhas de propriedades. |
|
Os itens especificados são destinos de descarte. |
|
Esse sinalizador é uma máscara para os atributos de funcionalidade: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET e SFGAO_DROPTARGET. Normalmente, os chamadores não usam esse valor. |
|
Windows 7 e posterior. Os itens especificados são itens do sistema. |
|
Os itens especificados são criptografados e podem exigir apresentação especial. |
| SFGAO_ISSLOW 0x00004000 |
Espera-se que o acesso ao item (por meio de IStream ou outras interfaces de armazenamento) seja uma operação lenta. Os aplicativos devem evitar acessar itens sinalizados com SFGAO_ISSLOW. Nota: Abrir um fluxo para um item geralmente é uma operação lenta o tempo todo. SFGAO_ISSLOW indica que espera-se que seja especialmente lento, por exemplo, no caso de conexões de rede lentas ou arquivos offline (FILE_ATTRIBUTE_OFFLINE). No entanto, consultar SFGAO_ISSLOW é uma operação lenta. Os aplicativos devem consultar SFGAO_ISSLOW apenas em um thread em segundo plano. Um método alternativo, como recuperar a propriedade PKEY_FileAttributes e o teste para FILE_ATTRIBUTE_OFFLINE, pode ser usado no lugar de uma chamada de método que envolve SFGAO_ISSLOW. |
|
Os itens especificados são mostrados como esmaecidos e indisponíveis para o usuário. |
|
Os itens especificados são atalhos. |
|
Os objetos especificados são compartilhados. |
|
Os itens especificados são somente leitura. No caso de pastas, isso significa que novos itens não podem ser criados nessas pastas. Isso não deve ser confundido com o comportamento especificado pelo sinalizador FILE_ATTRIBUTE_READONLY recuperado por IColumnProvider::GetItemData em uma estrutura SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY não tem nenhum significado para pastas do sistema de arquivos Win32. |
|
O item está oculto e não deve ser exibido, a menos que a opção Mostrar arquivos e pastas ocultos esteja habilitada em Configurações de Pasta. |
|
Não use. |
|
Os itens são itens não numerados e devem estar ocultos. Eles não são retornados por meio de um enumerador como o criado pelo método IShellFolder::EnumObjects . |
|
Os itens contêm novo conteúdo, conforme definido pelo aplicativo específico. |
|
Sem suporte. |
|
Sem suporte. |
|
Indica que o item tem um fluxo associado a ele. Esse fluxo pode ser acessado por meio de uma chamada para IShellFolder::BindToObject ou IShellItem::BindToHandler com IID_IStream no parâmetro riid . |
|
Os filhos deste item podem ser acessados por meio de IStream ou IStorage. Essas crianças são sinalizadas com SFGAO_STORAGE ou SFGAO_STREAM. |
|
Quando especificado como entrada, SFGAO_VALIDATE instrui a pasta a validar se os itens contidos em uma pasta ou matriz de itens do Shell existem. Se um ou mais desses itens não existirem, IShellFolder::GetAttributesOf e IShellItemArray::GetAttributes retornarão um código de falha. Esse sinalizador nunca é retornado como um valor [out]. Quando usada com a pasta do sistema de arquivos, SFGAO_VALIDATE instrui a pasta a descartar propriedades armazenadas em cache recuperadas por clientes de IShellFolder2::GetDetailsEx que podem ter se acumulado para os itens especificados. |
|
Os itens especificados estão em mídia removível ou são dispositivos removíveis. |
|
Os itens especificados são compactados. |
|
Os itens especificados podem ser hospedados dentro de um navegador da Web ou quadro do Windows Explorer. |
|
As pastas especificadas são pastas do sistema de arquivos ou contêm pelo menos um descendente (filho, neto ou posterior) que é uma pasta do sistema de arquivos (SFGAO_FILESYSTEM). |
|
Os itens especificados são pastas. Alguns itens podem ser sinalizados com SFGAO_STREAM e SFGAO_FOLDER, como um arquivo compactado com uma extensão de nome de arquivo .zip. Alguns aplicativos podem incluir esse sinalizador ao testar itens que são arquivos e contêineres. |
|
As pastas ou arquivos especificados fazem parte do sistema de arquivos (ou seja, são arquivos, diretórios ou diretórios raiz). Os nomes analisados dos itens podem ser considerados caminhos válidos do sistema de arquivos Win32. Esses caminhos podem ser baseados em UNC ou drive-letter. |
|
Esse sinalizador é uma máscara para os atributos de capacidade de armazenamento: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER e SFGAO_FILESYSTEM. Normalmente, os chamadores não usam esse valor. |
|
As pastas especificadas têm subpastas. O atributo SFGAO_HASSUBFOLDER é apenas consultoria e pode ser retornado por implementações de pasta do Shell, mesmo que elas não contenham subpastas. Observe, no entanto, que o inverso — falha ao retornar SFGAO_HASSUBFOLDER — afirma definitivamente que os objetos de pasta não têm subpastas. É recomendável retornar SFGAO_HASSUBFOLDER sempre que for necessário um período significativo de tempo para determinar se existem subpastas. Por exemplo, o Shell sempre retorna SFGAO_HASSUBFOLDER quando uma pasta está localizada em uma unidade de rede. |
|
Esse sinalizador é uma máscara para atributos de conteúdo, no momento apenas SFGAO_HASSUBFOLDER. Normalmente, os chamadores não usam esse valor. |
|
Máscara usada pela propriedade PKEY_SFGAOFlags para determinar atributos que são considerados para causar cálculos lentos ou falta de contexto: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER e SFGAO_VALIDATE. Normalmente, os chamadores não usam esse valor. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| parâmetro |
|
| IDL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de