GETPROPERTYSTOREFLAGS-Enumeration (propsys.h)
Gibt Flags an, die das Eigenschaftenspeicherobjekt ändern, das von Methoden abgerufen wird, die einen Eigenschaftenspeicher erstellen, z. B. IShellItem2::GetPropertyStore oder IPropertyStoreFactory::GetPropertyStore.
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
} ;
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 . |
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).
Hinweis GPS_INCLUDEOFFLINEPROPERTIES wurde durch GPS_OPENSLOWITEM abgelöst.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Kopfzeile | propsys.h |