Enumeración GETPROPERTYSTOREFLAGS (propsys.h)

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