Enumeração GETPROPERTYSTOREFLAGS (propsys.h)

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