Share via

GETPROPERTYSTOREFLAGS 列挙 (propsys.h)

  • [アーティクル]

IShellItem2::GetPropertyStore や 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
値: 0
呼び出しプロセスの意味: すべてのプロパティを含む読み取り専用プロパティ ストアを返します。 低速アイテム (オフライン ファイル) は開かれていません。



他のフラグとの組み合わせ: 他のフラグでオーバーライドできます。
GPS_HANDLERPROPERTIESONLY
値: 0x1
呼び出しプロセスの意味: プロパティ ハンドラーから直接プロパティのみを含めます。これにより、ディスク、ネットワーク、またはデバイス上のファイルが開きます。



ファイル フォルダーに対する意味: ハンドラーから直接プロパティのみを含めます。

他のフォルダーに対する意味: ファイル フォルダーに委任する場合は、このフラグをファイル フォルダーに渡します。多重化 (MUX) を行わないでください。 ファイル フォルダーに委任しない場合は、エラー コードを返す代わりに、このフラグを無視します。

他のフラグとの組み合わせ: GPS_TEMPORARY、GPS_FASTPROPERTIESONLY、またはGPS_BESTEFFORTと組み合わせることはできません。
GPS_READWRITE
値: 0x2
呼び出し元プロセスの意味: アイテムにプロパティを書き込むことができます。 注: ストアに含まれるプロパティは、読み取り専用ストアよりも少ない場合があります。



ファイル フォルダーの意味: ReadWrite。

他のフォルダーの意味: ReadWrite。 注: 既定の MUX を使用する場合は、既定の MUX が ReadWrite をサポートしていないため、1 つの多重化されていないストアを返します。

他のフラグとの組み合わせ: GPS_TEMPORARY、GPS_FASTPROPERTIESONLY、GPS_BESTEFFORT、またはGPS_DELAYCREATIONと組み合わせることはできません。 GPS_HANDLERPROPERTIESONLYを意味します。
GPS_TEMPORARY
値: 0x4
呼び出し元プロセスの意味: シェル項目インスタンスの有効期間中に存在する、初期プロパティのない書き込み可能なストアを提供します。基本的には、項目インスタンスに添付されたプロパティ バッグです。



ファイル フォルダーの意味: 適用できません。 シェル項目によって処理されます。

他のフォルダーの意味: 適用できません。 シェル項目によって処理されます。

他のフラグとの組み合わせ: 他のフラグと組み合わせることはできません。 GPS_READWRITEを意味します。
GPS_FASTPROPERTIESONLY
値: 0x8
呼び出し元プロセスの意味: ディスクまたはネットワークからの読み取りを伴わないストアを提供します。 注: 一部の値は、このフラグのないストアと比較して異なるか、欠落している可能性があります。



ファイル フォルダーの意味: "innate" ストアと "fallback" ストアのみを含めます。 ハンドラーを読み込まない。

他のフォルダーの意味: メモリ内で使用できるプロパティ、または非常に迅速に計算できるプロパティのみを含めます (ディスク、ネットワーク、または周辺機器 IO デバイスのプロパティはありません)。 これは通常、IDLIST からのデータ ソースのみです。 他のフォルダーに委任する場合は、このフラグをそれらに渡します。

他のフラグとの組み合わせ: GPS_TEMPORARY、GPS_READWRITE、GPS_HANDLERPROPERTIESONLY、またはGPS_DELAYCREATIONと組み合わせることはできません。
GPS_OPENSLOWITEM
値: 0x10
呼び出しプロセスの意味: 必要に応じて、低速アイテム (オフライン ファイル) を開きます。



ファイル フォルダーの意味: 必要に応じて、オフライン ストレージからファイルを取得します。 注: このフラグがないと、オフライン ファイルに対してハンドラーは作成されません。

他のフォルダーに対する意味: 非常に遅いプロパティを返さないでください。

他のフラグとの組み合わせ: GPS_TEMPORARYまたはGPS_FASTPROPERTIESONLYと組み合わせることはできません。
GPS_DELAYCREATION
値: 0x20
呼び出し元プロセスの意味: このようなアクセスを必要とするプロパティが要求されるまで、ファイル アクセスなどのメモリを集中的に使用する操作を遅延させます。



ファイル フォルダーの意味: 必要になるまでハンドラーを作成しないでください。たとえば、 GetCount/GetAt または GetValue のいずれかです。この場合、生来のストアは要求を満たしていません。 注: GetValue は、ファイル アクセスの問題が原因で失敗する可能性があります。

他のフォルダーの意味: フォルダーにファイル フォルダーへの委任やネットワーク アクセスなどのメモリ負荷の高いプロパティがある場合は、 IDelayedPropertyStoreFactory を サポートし、そのプロパティを高速で低速のストアに分割することで、パフォーマンスを最適化できます。 その後、遅延 MUX を使用してそれらを再結合できます。

他のフラグとの組み合わせ: GPS_TEMPORARYまたはGPS_READWRITEと組み合わせることはできません。
GPS_BESTEFFORT
値: 0x40
呼び出しプロセスの意味: 一部のプロパティが返されない場合でも、ストアの取得に成功します。 注: 一部の値は、このフラグのないストアと比較して異なるか、欠落している可能性があります。



ファイル フォルダーに対する意味: ハンドラーまたは生成されたストアの作成時にエラーが発生した場合でも、成功してストアを返します。 サブストアが失敗した場合にのみ失敗します。

他のフォルダーに対する意味: 一部のプロパティが返されない場合でも、ストアの取得に成功します。

他のフラグとの組み合わせ: GPS_TEMPORARY、GPS_READWRITE、またはGPS_HANDLERPROPERTIESONLYと組み合わせることはできません。
GPS_NO_OPLOCK
値: 0x80
Windows 7 以降。 呼び出し元は、oplock がない場合、バインド操作を続行できないため、ファイルで既に日和見ロック (oplock) を保持している場合にのみ、このフラグを使用する必要があります。 既定では、シェルはプロパティ ハンドラーにバインドする前に、ファイルに対して oplock を要求します。 このフラグは、既定の動作を無効にします。

Windows Server 2008 と Windows Vista: このフラグは使用できません。
GPS_PREFERQUERYPROPERTIES
値: 0x100
Windows 8 以降。 WDS 結果のインデクサーからプロパティのみを取得するには、このフラグを使用します。
GPS_EXTRINSICPROPERTIES
値: 0x200
ファイルのセカンダリ ストリームのプロパティを含めます。
GPS_EXTRINSICPROPERTIESONLY
値: 0x400
ファイルのセカンダリ ストリームのプロパティのみを含めます。
GPS_VOLATILEPROPERTIES
値: 0x800
GPS_VOLATILEPROPERTIESONLY
値: 0x1000
GPS_MASK_VALID
値: 0x1fff
有効な GETPROPERTYSTOREFLAGS 値のマスク。

注釈

シェル項目がファイルの場合、プロパティ ストアには次の項目が含まれます。

  • ファイルに関連するファイル システムのプロパティ。
  • ファイルがオフラインでない限り、ファイルのプロパティ ハンドラーによって提供されるファイル自体のプロパティ (「GPS_OPENSLOWITEM」を参照)。
ファイル以外のシェル項目は、同様の読み取り専用ストアを返します。
メモ GPS_INCLUDEOFFLINEPROPERTIESは、GPS_OPENSLOWITEMに置き換わりました。
 

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header propsys.h