IEnumSTATPROPSTG インターフェイス (propidlbase.h)

  • [アーティクル]

IEnumSTATPROPSTG インターフェイスは、STATPROPSTG 構造体の配列を反復処理します。 STATPROPSTG 構造体には、プロパティ セット内のプロパティに関する統計データが含まれています。 IEnumSTATPROPSTG には、すべての列挙子インターフェイス ( Next、 Skip、 Reset、 Clone) と同じメソッドがあります。

実装では、セット内のプロパティを列挙する順序を定義します。 列挙子の作成時に存在し、列挙中に削除されないプロパティは、1 回だけ列挙されます。 列挙の進行中に追加または削除されたプロパティは、列挙される場合と列挙されない場合がありますが、複数回列挙されることはありません。

予約済みプロパティ識別子、プロパティ ID が 0 (ディクショナリ)、1 (コード ページ インジケーター)、または0x80000000以上のプロパティは列挙されません。

非単純プロパティの列挙は、 IPropertyStorage::ReadMultiple の呼び出しによってプロパティを正常に読み取ることができることを必ずしも示すわけではありません。 これは、プロパティの列挙中に間接ストリームまたはストレージの存在を確認するパフォーマンス オーバーヘッドが非常に大きいためです。

継承

IEnumSTATPROPSTG インターフェイスは、IUnknown インターフェイスから継承します。 IEnumSTATPROPSTG には、次の種類のメンバーもあります。

メソッド

IEnumSTATPROPSTG インターフェイスには、これらのメソッドがあります。

 
IEnumSTATPROPSTG::Clone

IEnumSTATPROPSTG::Clone メソッドは、現在の STATPROPSTG 構造体列挙子と同じ列挙状態を含む列挙子を作成します。
IEnumSTATPROPSTG::Next

IEnumSTATPROPSTG::Next メソッドは、指定された数の STATPROPSTG 構造体を取得します。この構造体は、その後列挙シーケンスに続きます。
IEnumSTATPROPSTG::Reset

IEnumSTATPROPSTG::Reset メソッドは、列挙シーケンスを STATPROPSTG 構造体配列の先頭にリセットします。
IEnumSTATPROPSTG::Skip

IEnumSTATPROPSTG::Skip メソッドは、列挙シーケンス内の指定された数の STATPROPSTG 構造体をスキップします。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー propidlbase.h (Propidl.h を含む)

こちらもご覧ください

EnumAll サンプル

IPropertyStorage::Enum