IStorage::EnumElements-Methode (objidl.h)
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 |