IStorage::EnumElements-Methode (objidl.h)

  • Artikel

Die EnumElements-Methode ruft einen Zeiger auf ein Enumeratorobjekt ab, das zum Auflisten der in diesem Speicherobjekt enthaltenen Speicher- und Streamobjekte verwendet werden kann.

Syntax

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

Parameter

[in] reserved1

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[in] reserved2

Reserviert für zukünftige Verwendung; muss NULL sein.

[in] reserved3

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[out] ppenum

Zeiger auf die IEnumSTATSTG*-Zeigervariable, die den Schnittstellenzeiger auf das neue Enumeratorobjekt empfängt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Das Enumeratorobjekt wurde erfolgreich zurückgegeben.
E_PENDING Nur asynchroner Speicher: Ein Teil oder alle Daten des Elements sind derzeit nicht verfügbar.
STG_E_INSUFFICIENTMEMORY Das Enumeratorobjekt konnte aufgrund von Arbeitsspeichermangel nicht erstellt werden.
STG_E_INVALIDPARAMETER Einer der Parameter war ungültig.
STG_E_REVERTED Das Speicherobjekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.

Hinweise

Das von dieser Methode zurückgegebene Enumeratorobjekt implementiert die IEnumSTATSTG-Schnittstelle , eine der Standard-Enumeratorschnittstellen, die die Methoden Next, Reset, Clone und Skip enthalten. IEnumSTATSTG listet die Daten auf, die in einem Array von STATSTG-Strukturen gespeichert sind.

Das Speicherobjekt muss im Lesemodus geöffnet sein, um die Enumeration seiner Elemente zuzulassen.

Das Enumeratorobjekt darf die Elemente in beliebiger Reihenfolge auflisten. Das Enumeratorobjekt kann die Enumeration auch als Momentaufnahme behandeln oder den aktuellen Zustand des Speicherobjekts widerspiegeln.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h
Bibliothek Uuid.lib
DLL Ole32.dll

Weitere Informationen

IEnumSTATSTG

IStorage – Implementierung zusammengesetzter Dateien

STATSTG