Freigeben über


IEnumSTATPROPSTG-Compound Dateiimplementierung

Die zusammengesetzte Dateiimplementierung der IEnumSTATPROPSTG Schnittstelle wird zum Aufzählen von Eigenschaften verwendet, was zu STATPROPSTG- Strukturen führt, die statistische Eigenschaftsdaten enthalten. Die Implementierung von IPropertyStorage verwaltet die statistischen Daten und ist einem aktuellen zusammengesetzten Dateispeicherobjekt zugeordnet.

Der Konstruktor in der COM-Implementierung von IEnumSTATPROPSTG erstellt eine Klasse, die den gesamten Eigenschaftensatz liest, und erstellt ein statisches Array, das freigegeben werden kann, wenn IEnumSTATPROPSTG::Clone aufgerufen wird.

Wann verwendet werden soll

Rufen Sie die Verbunddateiimplementierung von IEnumSTATPROPSTG- auf, um die STATPROPSTG- Strukturen auflisten, die Daten zu den Eigenschaften innerhalb des aktuellen Eigenschaftensatzes enthalten. Rufen Sie bei Verwendung der zusammengesetzten Dateiimplementierung der Eigenschaftenspeicherschnittstellen IPropertyStorage::Enum auf, um einen Zeiger auf IEnumSTATPROPSTG- zurückzugeben, um das Eigenschaftsspeicherobjekt und die darin enthaltenen Elemente zu verwalten.

Bemerkungen

IEnumSTATPROPSTG::Next

Ruft die nächste oder mehrere STATPROPSTG- Strukturen ab (die Zahl wird durch den Celt Parameter angegeben). Gibt S_OK zurück, wenn dies erfolgreich ist.

IEnumSTATPROPSTG::Skip

Überspringt die Anzahl der in celtangegebenen Elemente. Das nächste Element, das über einen Aufruf von Next aufgezählt werden soll, wird dann nach den übersprungenen Elementen zum Element. Gibt S_OK zurück, wenn celt- Elemente übersprungen wurden; gibt S_FALSE zurück, wenn weniger als Celt Elemente übersprungen wurden.

IEnumSTATPROPSTG::Reset

Legt den Cursor auf den Anfang der Enumeration fest. Wenn dies erfolgreich ist, wird S_OK zurückgegeben, andernfalls wird STG_E_INVALIDHANDLE zurückgegeben.

IEnumSTATPROPSTG::Clone

Verwendet den Konstruktor für die IEnumSTATPROPSTG-, um eine Kopie des Arrays zu erstellen. Da die Klasse, die das statische Array erstellt, tatsächlich das Objekt enthält, fügt diese Funktion hauptsächlich der Verweisanzahl hinzu.

STATPROPSTG-

IPropertyStorage::Enum