GETPROPERTYSTOREFLAGS, énumération (propsys.h)

  • Article

Indique les indicateurs qui modifient l’objet de magasin de propriétés récupéré par les méthodes qui créent un magasin de propriétés, telles que 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
Valeur : 0
Signification d’un processus appelant : retourne un magasin de propriétés en lecture seule qui contient toutes les propriétés. Les éléments lents (fichiers hors connexion) ne sont pas ouverts.



Combinaison avec d’autres indicateurs : peut être remplacé par d’autres indicateurs.
GPS_HANDLERPROPERTIESONLY
Valeur : 0x1
Signification d’un processus d’appel : incluez uniquement les propriétés directement à partir du gestionnaire de propriétés, ce qui ouvre le fichier sur le disque, le réseau ou l’appareil.



Signification d’un dossier de fichiers : incluez uniquement les propriétés directement à partir du gestionnaire.

Signification à d’autres dossiers : lors de la délégation à un dossier de fichiers, transmettez cet indicateur au dossier de fichier ; n’effectuez aucun multiplexage (MUX). Lorsque vous ne déléguez pas à un dossier de fichiers, ignorez cet indicateur au lieu de retourner un code d’échec.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY, GPS_FASTPROPERTIESONLY ou GPS_BESTEFFORT.
GPS_READWRITE
Valeur : 0x2
Signification d’un processus d’appel : peut écrire des propriétés dans l’élément. Remarque : Le magasin peut contenir moins de propriétés qu’un magasin en lecture seule.



Signification d’un dossier de fichier : ReadWrite.

Signification pour d’autres dossiers : ReadWrite. Remarque : Lorsque vous utilisez MUX par défaut, retournez un seul magasin non multiplexe, car MUX par défaut ne prend pas en charge ReadWrite.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT ou GPS_DELAYCREATION. Implique GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Valeur : 0x4
Signification d’un processus d’appel : fournit un magasin accessible en écriture, sans propriétés initiales, qui existe pendant la durée de vie de l’élément Shell instance ; en gros, un sac de propriétés attaché à l’élément instance.



Signification d’un dossier de fichiers : non applicable. Géré par l’élément Shell.

Signification pour d’autres dossiers : non applicable. Géré par l’élément Shell.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec un autre indicateur. Implique GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Valeur : 0x8
Signification d’un processus d’appel : fournit un magasin qui n’implique pas la lecture à partir du disque ou du réseau. Remarque : Certaines valeurs peuvent être différentes ou manquantes par rapport à un magasin sans cet indicateur.



Signification d’un dossier de fichiers : incluez uniquement les magasins « innate » et « secours ». Ne chargez pas le gestionnaire.

Signification pour d’autres dossiers : incluez uniquement les propriétés disponibles en mémoire ou qui peuvent être calculées très rapidement (aucune propriété des disques, du réseau ou des appareils d’E/S périphériques). Il s’agit normalement uniquement des sources de données de l’IDLIST. Lors de la délégation à d’autres dossiers, transmettez-leur cet indicateur.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY ou GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Valeur : 0x10
Signification d’un processus d’appel : ouvrez un élément lent (fichier hors connexion) si nécessaire.



Signification d’un dossier de fichiers : récupérez un fichier à partir d’un stockage hors connexion, si nécessaire. Remarque : Sans cet indicateur, le gestionnaire n’est pas créé pour les fichiers hors connexion.

Signification pour d’autres dossiers : ne retournez pas de propriétés qui sont très lentes.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY ou GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Valeur : 0x20
Signification d’un processus d’appel : retarder les opérations nécessitant beaucoup de mémoire, telles que l’accès aux fichiers, jusqu’à ce qu’une propriété qui nécessite cet accès soit demandée.



Signification d’un dossier de fichiers : ne créez le gestionnaire que si nécessaire ; par exemple, GetCount/GetAt ou GetValue, où le magasin inné ne répond pas à la demande. Remarque : GetValue peut échouer en raison de problèmes d’accès aux fichiers.

Signification pour d’autres dossiers : si le dossier a des propriétés nécessitant beaucoup de mémoire, telles que la délégation à un dossier de fichiers ou à un accès réseau, il peut optimiser les performances en prenant en charge IDelayedPropertyStoreFactory et en fractionnant ses propriétés en un magasin rapide et lent. Il peut ensuite utiliser L’expérience MUX différée pour les recombiner.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY ou GPS_READWRITE.
GPS_BESTEFFORT
Valeur : 0x40
Signification d’un processus d’appel : réussir à obtenir le magasin, même si certaines propriétés ne sont pas retournées. Remarque : Certaines valeurs peuvent être différentes ou manquantes par rapport à un magasin sans cet indicateur.



Signification d’un dossier de fichiers : réussite et retour d’un magasin, même si le gestionnaire ou le magasin inné présente une erreur lors de la création. Échoue uniquement si les sous-magasins échouent.

Signification pour d’autres dossiers : réussir lors de l’obtention du magasin, même si certaines propriétés ne sont pas retournées.

Combinaison avec d’autres indicateurs : ne peut pas être combiné avec GPS_TEMPORARY, GPS_READWRITE ou GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Valeur : 0x80
Windows 7 et versions ultérieures. Les appelants doivent utiliser cet indicateur uniquement s’ils détiennent déjà un verrou opportuniste (oplock) sur le fichier, car sans oplock, l’opération de liaison ne peut pas continuer. Par défaut, l’interpréteur de commandes demande un oplock sur un fichier avant de le lier au gestionnaire de propriétés. Cet indicateur désactive le comportement par défaut.

Windows Server 2008 et Windows Vista : Cet indicateur n’est pas disponible.
GPS_PREFERQUERYPROPERTIES
Valeur : 0x100
Windows 8 et versions ultérieures. Utilisez cet indicateur pour récupérer uniquement les propriétés de l’indexeur pour les résultats WDS.
GPS_EXTRINSICPROPERTIES
Valeur : 0x200
Incluez les propriétés du flux secondaire du fichier.
GPS_EXTRINSICPROPERTIESONLY
Valeur : 0x400
Incluez uniquement les propriétés du flux secondaire du fichier.
GPS_VOLATILEPROPERTIES
Valeur : 0x800
GPS_VOLATILEPROPERTIESONLY
Valeur : 0x1000
GPS_MASK_VALID
Valeur : 0x1fff
Masque pour les valeurs GETPROPERTYSTOREFLAGS valides .

Remarques

Si l’élément Shell est un fichier, le magasin de propriétés contient les éléments suivants.

  • Propriétés du système de fichiers qui concernent le fichier.
  • Propriétés du fichier lui-même fournies par le gestionnaire de propriétés du fichier, sauf si le fichier est hors connexion (voir GPS_OPENSLOWITEM).
Les éléments shell non-fichier retournent un magasin en lecture seule similaire.
Note GPS_INCLUDEOFFLINEPROPERTIES a été remplacé par GPS_OPENSLOWITEM.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête propsys.h