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 |