Compartilhar via

Enumeração GETPROPERTYSTOREFLAGS (propsys.h)

  • Artigo

Indica sinalizadores que modificam o objeto de repositório de propriedades recuperado por métodos que criam um repositório de propriedades, como IShellItem2::GetPropertyStore ou IPropertyStoreFactory::GetPropertyStore.

Syntax

typedef enum GETPROPERTYSTOREFLAGS {
  GPS_DEFAULT = 0,
  GPS_HANDLERPROPERTIESONLY = 0x1,
  GPS_READWRITE = 0x2,
  GPS_TEMPORARY = 0x4,
  GPS_FASTPROPERTIESONLY = 0x8,
  GPS_OPENSLOWITEM = 0x10,
  GPS_DELAYCREATION = 0x20,
  GPS_BESTEFFORT = 0x40,
  GPS_NO_OPLOCK = 0x80,
  GPS_PREFERQUERYPROPERTIES = 0x100,
  GPS_EXTRINSICPROPERTIES = 0x200,
  GPS_EXTRINSICPROPERTIESONLY = 0x400,
  GPS_VOLATILEPROPERTIES = 0x800,
  GPS_VOLATILEPROPERTIESONLY = 0x1000,
  GPS_MASK_VALID = 0x1fff
} ;

Constantes

 
GPS_DEFAULT
Valor: 0
Significado para um processo de chamada: retorna um repositório de propriedades somente leitura que contém todas as propriedades. Itens lentos (arquivos offline) não são abertos.



Combinação com outros sinalizadores: pode ser substituído por outros sinalizadores.
GPS_HANDLERPROPERTIESONLY
Valor: 0x1
Significado para um processo de chamada: inclua apenas propriedades diretamente do manipulador de propriedades, que abre o arquivo no disco, na rede ou no dispositivo.



Significado para uma pasta de arquivo: inclua apenas propriedades diretamente do manipulador.

Significado para outras pastas: ao delegar a uma pasta de arquivo, passe esse sinalizador para a pasta de arquivos; não faça multiplexação (MUX). Ao não delegar a uma pasta de arquivo, ignore esse sinalizador em vez de retornar um código de falha.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY, GPS_FASTPROPERTIESONLY ou GPS_BESTEFFORT.
GPS_READWRITE
Valor: 0x2
Significado para um processo de chamada: pode gravar propriedades no item. Observação: o repositório pode conter menos propriedades do que um repositório somente leitura.



Significado para uma pasta de arquivo: ReadWrite.

Significado para outras pastas: ReadWrite. Observação: ao usar o MUX padrão, retorne um único repositório nãoultiplexado porque o MUX padrão não dá suporte a ReadWrite.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT ou GPS_DELAYCREATION. Implica GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Valor: 0x4
Significado para um processo de chamada: fornece um repositório gravável, sem propriedades iniciais, que existe durante o tempo de vida da instância de item do Shell; basicamente, um recipiente de propriedades anexado à instância do item.



Significado para uma pasta de arquivo: não aplicável. Manipulado pelo item Shell.

Significado para outras pastas: não aplicável. Manipulado pelo item Shell.

Combinação com outros sinalizadores: não pode ser combinado com nenhum outro sinalizador. Implica GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Valor: 0x8
Significado para um processo de chamada: fornece um repositório que não envolve a leitura do disco ou da rede. Observação: alguns valores podem ser diferentes ou ausentes em comparação com um repositório sem esse sinalizador.



Significado para uma pasta de arquivos: inclua apenas os repositórios "inatas" e "fallback". Não carregue o manipulador.

Significado para outras pastas: inclua apenas as propriedades que estão disponíveis na memória ou que podem ser computadas muito rapidamente (nenhuma propriedade de dispositivos de E/S de disco, rede ou periféricos). Normalmente, são apenas fontes de dados da IDLIST. Ao delegar para outras pastas, passe esse sinalizador para elas.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY ou GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Valor: 0x10
Significado para um processo de chamada: abra um item lento (arquivo offline), se necessário.



Significado para uma pasta de arquivos: recupere um arquivo do armazenamento offline, se necessário. Observação: sem esse sinalizador, o manipulador não é criado para arquivos offline.

Significado para outras pastas: não retorne nenhuma propriedade muito lenta.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY ou GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Valor: 0x20
Significado para um processo de chamada: atrase operações com uso intensivo de memória, como o acesso a arquivos, até que uma propriedade seja solicitada que exija esse acesso.



Significado para uma pasta de arquivo: não crie o manipulador até que seja necessário; por exemplo, GetCount/GetAt ou GetValue, em que o repositório inato não atende à solicitação. Observação: GetValue pode falhar devido a problemas de acesso a arquivos.

Significado para outras pastas: se a pasta tiver propriedades com uso intensivo de memória, como delegar a uma pasta de arquivo ou acesso à rede, ela poderá otimizar o desempenho dando suporte a IDelayedPropertyStoreFactory e dividindo suas propriedades em um repositório rápido e lento. Em seguida, ele pode usar o MUX atrasado para recombiná-los.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY ou GPS_READWRITE.
GPS_BESTEFFORT
Valor: 0x40
Significado para um processo de chamada: tenha êxito ao obter o repositório, mesmo que algumas propriedades não sejam retornadas. Observação: alguns valores podem ser diferentes ou ausentes em comparação com um repositório sem esse sinalizador.



Significado para uma pasta de arquivo: tenha êxito e retorne um repositório, mesmo que o manipulador ou o repositório inato tenha um erro durante a criação. Só falhará se os substores falharem.

Significado para outras pastas: tenha êxito ao obter o repositório, mesmo que algumas propriedades não sejam retornadas.

Combinação com outros sinalizadores: não pode ser combinado com GPS_TEMPORARY, GPS_READWRITE ou GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Valor: 0x80
Windows 7 e posterior. Os chamadores devem usar esse sinalizador somente se já estiverem segurando um bloqueio oportunista (oplock) no arquivo porque, sem um oplock, a operação de associação não pode continuar. Por padrão, o Shell solicita um oplock em um arquivo antes de associar ao manipulador de propriedades. Esse sinalizador desabilita o comportamento padrão.

Windows Server 2008 e Windows Vista: Esse sinalizador não está disponível.
GPS_PREFERQUERYPROPERTIES
Valor: 0x100
Windows 8 e posterior. Use esse sinalizador para recuperar somente as propriedades do indexador para resultados do WDS.
GPS_EXTRINSICPROPERTIES
Valor: 0x200
Inclua propriedades do fluxo secundário do arquivo.
GPS_EXTRINSICPROPERTIESONLY
Valor: 0x400
Inclua apenas as propriedades do fluxo secundário do arquivo.
GPS_VOLATILEPROPERTIES
Valor: 0x800
GPS_VOLATILEPROPERTIESONLY
Valor: 0x1000
GPS_MASK_VALID
Valor: 0x1fff
Máscara para valores GETPROPERTYSTOREFLAGS válidos.

Comentários

Se o item Shell for um arquivo, o repositório de propriedades conterá os itens a seguir.

  • Propriedades do sistema de arquivos que dizem respeito ao arquivo.
  • Propriedades do próprio arquivo que são fornecidas pelo manipulador de propriedades do arquivo, a menos que o arquivo esteja offline (consulte GPS_OPENSLOWITEM).
Itens do Shell que não são de arquivo retornam um repositório somente leitura semelhante.
Nota GPS_INCLUDEOFFLINEPROPERTIES foi substituído por GPS_OPENSLOWITEM.
 

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]
Cabeçalho propsys.h