GETPROPERTYSTOREFLAGS-Enumeration (propsys.h)

  • Artikel

Gibt Flags an, die das Eigenschaftenspeicherobjekt ändern, das von Methoden abgerufen wird, die einen Eigenschaftenspeicher erstellen, z. B. IShellItem2::GetPropertyStore oder 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
} ;

Konstanten

 
GPS_DEFAULT
Wert: 0
Bedeutung für einen aufrufenden Prozess: Gibt einen schreibgeschützten Eigenschaftenspeicher zurück, der alle Eigenschaften enthält. Langsame Elemente (Offlinedateien) werden nicht geöffnet.



Kombination mit anderen Flags: Kann von anderen Flags überschrieben werden.
GPS_HANDLERPROPERTIESONLY
Wert: 0x1
Bedeutung für einen aufrufenden Prozess: Schließen Sie nur Eigenschaften direkt aus dem Eigenschaftenhandler ein, der die Datei auf dem Datenträger, im Netzwerk oder auf dem Gerät öffnet.



Bedeutung für einen Dateiordner: Schließen Sie nur Eigenschaften direkt aus dem Handler ein.

Bedeutung für andere Ordner: Wenn Sie in einen Dateiordner delegieren, übergeben Sie dieses Flag an den Dateiordner; kein Multiplexing (MUX) durchführen. Wenn Sie nicht an einen Dateiordner delegieren, ignorieren Sie dieses Flag, anstatt einen Fehlercode zurückzugeben.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY, GPS_FASTPROPERTIESONLY oder GPS_BESTEFFORT kombiniert werden.
GPS_READWRITE
Wert: 0x2
Bedeutung für einen aufrufenden Prozess: Kann Eigenschaften in das Element schreiben. Hinweis: Der Speicher kann weniger Eigenschaften als ein schreibgeschützter Speicher enthalten.



Bedeutung für einen Dateiordner: ReadWrite.

Bedeutung für andere Ordner: ReadWrite. Hinweis: Geben Sie bei Verwendung von Standard-MUX einen einzelnen unmultiplexierten Speicher zurück, da der Standard-MUX ReadWrite nicht unterstützt.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT oder GPS_DELAYCREATION kombiniert werden. Impliziert GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Wert: 0x4
Bedeutung für einen aufrufenden Prozess: Stellt einen schreibbaren Speicher ohne anfängliche Eigenschaften bereit, der für die Lebensdauer des Shellelements instance vorhanden ist. Im Grunde genommen wird ein Eigenschaftenbehälter, der an das Element angefügt instance.



Bedeutung für einen Dateiordner: Nicht zutreffend. Wird vom Shellelement behandelt.

Bedeutung für andere Ordner: Nicht zutreffend. Wird vom Shellelement behandelt.

Kombination mit anderen Flags: Kann nicht mit anderen Flags kombiniert werden. Impliziert GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Wert: 0x8
Bedeutung für einen aufrufenden Prozess: Stellt einen Speicher bereit, der nicht vom Datenträger oder Netzwerk gelesen wird. Hinweis: Einige Werte können sich im Vergleich zu einem Speicher ohne dieses Flag unterscheiden oder fehlen.



Bedeutung für einen Dateiordner: Schließen Sie nur die Speicher "innate" und "fallback" ein. Laden Sie den Handler nicht.

Bedeutung für andere Ordner: Schließen Sie nur Eigenschaften ein, die im Arbeitsspeicher verfügbar sind oder sehr schnell berechnet werden können (keine Eigenschaften von Datenträger-, Netzwerk- oder Peripherie-E/A-Geräten). Dies sind normalerweise nur Datenquellen aus der IDLIST. Wenn Sie an andere Ordner delegieren, übergeben Sie dieses Flag an diese.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY oder GPS_DELAYCREATION kombiniert werden.
GPS_OPENSLOWITEM
Wert: 0x10
Bedeutung für einen aufrufenden Prozess: Öffnen Sie bei Bedarf ein langsames Element (Offlinedatei).



Bedeutung für einen Dateiordner: Rufen Sie bei Bedarf eine Datei aus dem Offlinespeicher ab. Hinweis: Ohne dieses Flag wird der Handler nicht für Offlinedateien erstellt.

Bedeutung für andere Ordner: Geben Sie keine Eigenschaften zurück, die sehr langsam sind.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY oder GPS_FASTPROPERTIESONLY kombiniert werden.
GPS_DELAYCREATION
Wert: 0x20
Bedeutung für einen aufrufenden Prozess: Verzögern Sie speicherintensive Vorgänge, z. B. dateizugriff, bis eine Eigenschaft angefordert wird, die einen solchen Zugriff erfordert.



Bedeutung für einen Dateiordner: Erstellen Sie den Handler erst, wenn sie benötigt wird; Beispielsweise entweder GetCount/GetAt oder GetValue, wobei der angeborene Speicher die Anforderung nicht erfüllt. Hinweis: GetValue kann aufgrund von Dateizugriffsproblemen fehlschlagen.

Bedeutung für andere Ordner: Wenn der Ordner über speicherintensive Eigenschaften verfügt, z. B. das Delegieren an einen Dateiordner oder den Netzwerkzugriff, kann er die Leistung optimieren, indem er IDelayedPropertyStoreFactory unterstützt und seine Eigenschaften in einen schnellen und einen langsamen Speicher aufteilt. Sie kann dann verzögerte MUX verwenden, um sie erneut zu verkombinieren.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY oder GPS_READWRITE kombiniert werden.
GPS_BESTEFFORT
Wert: 0x40
Bedeutung für einen aufrufenden Prozess: Erfolgreich beim Abrufen des Speichers, auch wenn einige Eigenschaften nicht zurückgegeben werden. Hinweis: Einige Werte können sich im Vergleich zu einem Speicher ohne dieses Flag unterscheiden oder fehlen.



Bedeutung für einen Dateiordner: Erfolgreich, und geben Sie einen Speicher zurück, auch wenn der Handler oder der angeborene Speicher während der Erstellung einen Fehler aufweist. Fehler nur, wenn Unterspeicher fehlschlagen.

Bedeutung für andere Ordner: Erfolgreich beim Abrufen des Speichers, auch wenn einige Eigenschaften nicht zurückgegeben werden.

Kombination mit anderen Flags: Kann nicht mit GPS_TEMPORARY, GPS_READWRITE oder GPS_HANDLERPROPERTIESONLY kombiniert werden.
GPS_NO_OPLOCK
Wert: 0x80
Windows 7 und höher. Aufrufer sollten dieses Flag nur verwenden, wenn sie bereits eine opportunistische Sperre (Oplock) für die Datei halten, da der Bindungsvorgang ohne oplock nicht fortgesetzt werden kann. Standardmäßig fordert die Shell einen Oplock für eine Datei an, bevor sie an den Eigenschaftenhandler gebunden wird. Dieses Flag deaktiviert das Standardverhalten.

Windows Server 2008 und Windows Vista: Dieses Flag ist nicht verfügbar.
GPS_PREFERQUERYPROPERTIES
Wert: 0x100
Windows 8 und höher. Verwenden Sie dieses Flag, um nur Eigenschaften aus dem Indexer für WDS-Ergebnisse abzurufen.
GPS_EXTRINSICPROPERTIES
Wert: 0x200
Schließen Sie Eigenschaften aus dem sekundären Datenstrom der Datei ein.
GPS_EXTRINSICPROPERTIESONLY
Wert: 0x400
Schließen Sie nur Eigenschaften aus dem sekundären Datenstrom der Datei ein.
GPS_VOLATILEPROPERTIES
Wert: 0x800
GPS_VOLATILEPROPERTIESONLY
Wert: 0x1000
GPS_MASK_VALID
Wert: 0x1fff
Maskierung für gültige GETPROPERTYSTOREFLAGS-Werte .

Hinweise

Wenn das Shell-Element eine Datei ist, enthält der Eigenschaftenspeicher die folgenden Elemente.

  • Eigenschaften aus dem Dateisystem, die die Datei betreffen.
  • Eigenschaften aus der Datei selbst, die vom Eigenschaftenhandler der Datei bereitgestellt werden, es sei denn, die Datei ist offline (siehe GPS_OPENSLOWITEM).
Shellelemente ohne Datei geben einen ähnlichen schreibgeschützten Speicher zurück.
Hinweis GPS_INCLUDEOFFLINEPROPERTIES wurde durch GPS_OPENSLOWITEM abgelöst.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile propsys.h