Condividi tramite

Enumerazione GETPROPERTYSTOREFLAGS (propsys.h)

  • Articolo

Indica i flag che modificano l'oggetto archivio proprietà recuperato dai metodi che creano un archivio proprietà, ad esempio IShellItem2::GetPropertyStore o IPropertyStoreFactory::GetPropertyStore.

Sintassi

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
} ;

Costanti

 
GPS_DEFAULT
Valore: 0
Significato di un processo chiamante: restituire un archivio proprietà di sola lettura che contiene tutte le proprietà. Gli elementi lenti (file offline) non vengono aperti.



Combinazione con altri flag: può essere sottoposto a override da altri flag.
GPS_HANDLERPROPERTIESONLY
Valore: 0x1
Significato di un processo chiamante: includere solo le proprietà direttamente dal gestore delle proprietà, che apre il file sul disco, sulla rete o sul dispositivo.



Significato di una cartella file: includere solo proprietà direttamente dal gestore.

Significato per altre cartelle: quando si delega a una cartella file, passare questo flag alla cartella file; non eseguire il multiplexing (MUX). Quando non delega a una cartella di file, ignorare questo flag anziché restituire un codice di errore.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY, GPS_FASTPROPERTIESONLY o GPS_BESTEFFORT.
GPS_READWRITE
Valore: 0x2
Significato di un processo chiamante: può scrivere proprietà nell'elemento. Nota: l'archivio può contenere meno proprietà di un archivio di sola lettura.



Significato di una cartella file: ReadWrite.

Significato per altre cartelle: ReadWrite. Nota: quando si usa MUX predefinito, restituire un singolo archivio non multiplexed perché l'predefinito MUX non supporta ReadWrite.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT o GPS_DELAYCREATION. Implica GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Valore: 0x4
Significato di un processo chiamante: fornisce un archivio scrivibile, senza proprietà iniziali, esistenti per la durata dell'istanza dell'elemento shell; fondamentalmente, un contenitore di proprietà collegato all'istanza dell'elemento.



Significato di una cartella di file: non applicabile. Gestito dall'elemento Shell.

Significato per altre cartelle: non applicabile. Gestito dall'elemento Shell.

Combinazione con altri flag: non può essere combinata con qualsiasi altro flag. Implica GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Valore: 0x8
Significato di un processo chiamante: fornisce un archivio che non comporta la lettura dal disco o dalla rete. Nota: alcuni valori possono essere diversi o mancanti, rispetto a un archivio senza questo flag.



Significato di una cartella file: includere solo gli archivi "innate" e "fallback". Non caricare il gestore.

Significato per altre cartelle: includere solo le proprietà disponibili in memoria o possono essere calcolate molto rapidamente (nessuna proprietà da dischi, rete o dispositivi I/O periferici). Questa è in genere solo origini dati dall'IDLIST. Quando si delega ad altre cartelle, passare questo flag a loro.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY o GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Valore: 0x10
Significato di un processo chiamante: aprire un elemento lento (file offline) se necessario.



Significato di una cartella file: recuperare un file dall'archiviazione offline, se necessario. Nota: senza questo flag, il gestore non viene creato per i file offline.

Significato per altre cartelle: non restituire alcuna proprietà molto lenta.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY o GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Valore: 0x20
Significato di un processo chiamante: ritardare operazioni a elevato utilizzo di memoria, ad esempio l'accesso ai file, fino a quando non viene richiesta una proprietà che richiede tale accesso.



Significato di una cartella file: non creare il gestore fino a quando necessario; Ad esempio, GetCount/GetAt o GetValue, in cui l'archivio innato non soddisfa la richiesta. Nota: GetValue potrebbe non riuscire a causa di problemi di accesso ai file.

Significato per altre cartelle: se la cartella ha proprietà a elevato utilizzo di memoria, ad esempio delega a una cartella di file o a un accesso di rete, può ottimizzare le prestazioni supportando IDelayedPropertyStoreFactory e suddividendone le proprietà in un archivio veloce e lento. Può quindi usare MUX ritardato per ricombinarli.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY o GPS_READWRITE.
GPS_BESTEFFORT
Valore: 0x40
Significato di un processo chiamante: è possibile ottenere l'archivio, anche se alcune proprietà non vengono restituite. Nota: alcuni valori possono essere diversi o mancanti, rispetto a un archivio senza questo flag.



Significato di una cartella file: riuscita e restituzione di un archivio, anche se il gestore o l'archivio innato ha un errore durante la creazione. Errore solo se i sottostore hanno esito negativo.

Significato per altre cartelle: è possibile ottenere l'archivio, anche se alcune proprietà non vengono restituite.

Combinazione con altri flag: impossibile combinare GPS_TEMPORARY, GPS_READWRITE o GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Valore: 0x80
Windows 7 e versioni successive. I chiamanti devono usare questo flag solo se sono già in possesso di un blocco opportunistico (oplock) nel file perché senza un oplock, l'operazione di associazione non può continuare. Per impostazione predefinita, Shell richiede un oplock in un file prima dell'associazione al gestore delle proprietà. Questo flag disabilita il comportamento predefinito.

Windows Server 2008 e Windows Vista: Questo flag non è disponibile.
GPS_PREFERQUERYPROPERTIES
Valore: 0x100
Windows 8 e versioni successive. Usare questo flag per recuperare solo le proprietà dall'indicizzatore per i risultati wdS.
GPS_EXTRINSICPROPERTIES
Valore: 0x200
Includere le proprietà dal flusso secondario del file.
GPS_EXTRINSICPROPERTIESONLY
Valore: 0x400
Includere solo le proprietà del flusso secondario del file.
GPS_VOLATILEPROPERTIES
Valore: 0x800
GPS_VOLATILEPROPERTIESONLY
Valore: 0x1000
GPS_MASK_VALID
Valore: 0x1fff
Maschera per i valori GETPROPERTYSTOREFLAGS validi.

Commenti

Se l'elemento Shell è un file, l'archivio delle proprietà contiene gli elementi seguenti.

  • Proprietà dal file system che riguarda il file system.
  • Proprietà dal file stesso fornito dal gestore delle proprietà del file, a meno che il file non sia offline (vedere GPS_OPENSLOWITEM).
Gli elementi di Shell non file restituiscono un archivio di sola lettura simile.
Nota GPS_INCLUDEOFFLINEPROPERTIES è stata sostituita da GPS_OPENSLOWITEM.
 

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione propsys.h