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 |