IStorage::EnumElements メソッド (objidl.h)

EnumElements メソッドは、このストレージ オブジェクトに含まれるストレージ オブジェクトとストリーム オブジェクトを列挙するために使用できる列挙子オブジェクトへのポインターを取得します。

構文

HRESULT EnumElements(
  [in]  DWORD        reserved1,
  [in]  void         *reserved2,
  [in]  DWORD        reserved3,
  [out] IEnumSTATSTG **ppenum
);

パラメーター

[in] reserved1

今後使用するために予約されています。0 にする必要があります。

[in] reserved2

将来の使用のために予約されています。 は NULL である必要があります。

[in] reserved3

今後使用するために予約されています。0 にする必要があります。

[out] ppenum

新しい列挙子オブジェクトへのインターフェイス ポインターを受け取る IEnumSTATSTG* ポインター変数へのポインター。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	列挙子オブジェクトが正常に返されました。
E_PENDING	非同期ストレージのみ: 要素のデータの一部またはすべてを現在使用できません。
STG_E_INSUFFICIENTMEMORY	メモリ不足のため、列挙子オブジェクトを作成できませんでした。
STG_E_INVALIDPARAMETER	パラメーターの 1 つが無効でした。
STG_E_REVERTED	ストレージ オブジェクトは、トランザクション ツリーの上にある元に戻す操作によって無効になっています。

注釈

このメソッドによって返される列挙子オブジェクトは、 IEnumSTATSTG インターフェイス ( Next、 Reset、 Clone、Skip メソッドを含む標準列挙子インターフェイスの 1 つ) を 実装します。 IEnumSTATSTG は、STATSTG 構造体の配列に格納されているデータを列挙します。

ストレージ オブジェクトを読み取りモードで開いて、その要素の列挙を許可する必要があります。

列挙子オブジェクトは、任意の順序で要素を列挙できます。 列挙子オブジェクトは、列挙体をスナップショットとして処理したり、列挙体にストレージ オブジェクトの現在の状態を反映させたりすることもできます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	objidl.h
Library	Uuid.lib
[DLL]	Ole32.dll

こちらもご覧ください

IEnumSTATSTG

IStorage - 複合ファイルの実装

Statstg