Compartir a través de

Enumeración GETPROPERTYSTOREFLAGS (propsys.h)

  • Artículo

Indica marcas que modifican el objeto de almacén de propiedades recuperado por métodos que crean un almacén de propiedades, como IShellItem2::GetPropertyStore o 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 de un proceso de llamada: devuelve un almacén de propiedades de solo lectura que contiene todas las propiedades. No se abren elementos lentos (archivos sin conexión).



Combinación con otras marcas: se puede invalidar por otras marcas.
GPS_HANDLERPROPERTIESONLY
Valor: 0x1
Significado para un proceso de llamada: incluya solo las propiedades directamente desde el controlador de propiedades, que abre el archivo en el disco, la red o el dispositivo.



Significado para una carpeta de archivos: incluya solo las propiedades directamente desde el controlador.

Significado para otras carpetas: al delegar en una carpeta de archivos, pase esta marca a la carpeta de archivos; no realice ninguna multiplexación (MUX). Al no delegar en una carpeta de archivos, omita esta marca en lugar de devolver un código de error.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY, GPS_FASTPROPERTIESONLY o GPS_BESTEFFORT.
GPS_READWRITE
Valor: 0x2
Significado de un proceso de llamada: puede escribir propiedades en el elemento. Nota: El almacén puede contener menos propiedades que un almacén de solo lectura.



Significado de una carpeta de archivos: ReadWrite.

Significado para otras carpetas: ReadWrite. Nota: Al usar MUX predeterminado, devuelve un único almacén sinmultiplexar porque el MUX predeterminado no admite ReadWrite.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT o GPS_DELAYCREATION. Implica GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Valor: 0x4
Significado de un proceso de llamada: proporciona un almacén grabable, sin propiedades iniciales, que existe durante la vigencia de la instancia del elemento shell; básicamente, un contenedor de propiedades asociado a la instancia de elemento.



Significado de una carpeta de archivos: no aplicable. Controlado por el elemento shell.

Significado para otras carpetas: No aplicable. Controlado por el elemento shell.

Combinación con otras marcas: no se puede combinar con ninguna otra marca. Implica GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Valor: 0x8
Significado de un proceso de llamada: proporciona un almacén que no implica la lectura desde el disco o la red. Nota: Algunos valores pueden ser diferentes o faltan, en comparación con un almacén sin esta marca.



Significado de una carpeta de archivos: incluya solo los almacenes "innate" y "fallback". No cargue el controlador.

Significado para otras carpetas: incluya solo las propiedades que están disponibles en la memoria o se pueden calcular muy rápidamente (sin propiedades de los dispositivos de E/S periféricos, de red o de disco). Normalmente, solo son orígenes de datos de IDLIST. Al delegar en otras carpetas, pase esta marca a ellas.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY o GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Valor: 0x10
Significado de un proceso de llamada: abra un elemento lento (archivo sin conexión) si es necesario.



Significado de una carpeta de archivos: recupere un archivo del almacenamiento sin conexión, si es necesario. Nota: Sin esta marca, el controlador no se crea para archivos sin conexión.

Significado para otras carpetas: no devuelva ninguna propiedad que sea muy lenta.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY o GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Valor: 0x20
Significado de un proceso de llamada: retrasar las operaciones de uso intensivo de memoria, como el acceso a archivos, hasta que se solicite una propiedad que requiera dicho acceso.



Significado para una carpeta de archivos: no cree el controlador hasta que sea necesario; por ejemplo, GetCount/GetAt o GetValue, donde el almacén innate no satisface la solicitud. Nota: GetValue puede producir un error debido a problemas de acceso a archivos.

Significado para otras carpetas: si la carpeta tiene propiedades que consumen mucha memoria, como delegar en una carpeta de archivos o acceso a la red, puede optimizar el rendimiento al admitir IDelayedPropertyStoreFactory y dividir sus propiedades en un almacén rápido y lento. A continuación, puede usar MUX retrasado para volver a ensamblarlos.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY o GPS_READWRITE.
GPS_BESTEFFORT
Valor: 0x40
Significado de un proceso de llamada: se realiza correctamente al obtener el almacén, incluso si no se devuelven algunas propiedades. Nota: Algunos valores pueden ser diferentes o faltan, en comparación con un almacén sin esta marca.



Significado para una carpeta de archivos: se realiza correctamente y se devuelve un almacén, incluso si el controlador o el almacén innato tienen un error durante la creación. Solo se produce un error si se produce un error en los substores.

Significado para otras carpetas: se realiza correctamente al obtener el almacén, incluso si no se devuelven algunas propiedades.

Combinación con otras marcas: no se puede combinar con GPS_TEMPORARY, GPS_READWRITE o GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Valor: 0x80
Windows 7 y versiones posteriores. Los autores de llamadas solo deben usar esta marca si ya contienen un bloqueo oportunista (oplock) en el archivo porque, sin un interbloqueo, la operación de enlace no puede continuar. De forma predeterminada, el Shell solicita un interbloqueo en un archivo antes de enlazar al controlador de propiedades. Esta marca deshabilita el comportamiento predeterminado.

Windows Server 2008 y Windows Vista: Esta marca no está disponible.
GPS_PREFERQUERYPROPERTIES
Valor: 0x100
Windows 8 y versiones posteriores. Use esta marca para recuperar solo las propiedades del indexador para los resultados de WDS.
GPS_EXTRINSICPROPERTIES
Valor: 0x200
Incluya las propiedades de la secuencia secundaria del archivo.
GPS_EXTRINSICPROPERTIESONLY
Valor: 0x400
Incluya solo las propiedades de la secuencia secundaria del archivo.
GPS_VOLATILEPROPERTIES
Valor: 0x800
GPS_VOLATILEPROPERTIESONLY
Valor: 0x1000
GPS_MASK_VALID
Valor: 0x1fff
Máscara para valores GETPROPERTYSTOREFLAGS válidos .

Comentarios

Si el elemento shell es un archivo, el almacén de propiedades contiene los siguientes elementos.

  • Propiedades del sistema de archivos que se refieren al archivo.
  • Propiedades del propio archivo proporcionados por el controlador de propiedades del archivo, a menos que el archivo esté sin conexión (consulte GPS_OPENSLOWITEM).
Los elementos de Shell que no son de archivo devuelven un almacén de solo lectura similar.
Nota GPS_INCLUDEOFFLINEPROPERTIES ha sido reemplazado por GPS_OPENSLOWITEM.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado propsys.h