IEnumSTATPROPSTG-Compound Dateiimplementierung
Die Zusammengesetzte Dateiimplementierung der IEnumSTATPROPSTG-Schnittstelle wird verwendet, um Eigenschaften aufzulisten, was zu STATPROPSTG-Strukturen führt, die statistische Eigenschaftendaten 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.
Einsatzgebiet
Rufen Sie die Verbunddateiimplementierung von IEnumSTATPROPSTG auf, um die STATPROPSTG-Strukturen aufzulisten, die Daten zu den Eigenschaften im aktuellen Eigenschaftensatz enthalten. Wenn Sie die Zusammengesetzte Dateiimplementierung der Eigenschaftenspeicherschnittstellen verwenden, rufen Sie IPropertyStorage::Enum auf, um einen Zeiger auf IEnumSTATPROPSTG zurückzugeben, um das Eigenschaftenspeicherobjekt und die darin enthaltenen Elemente zu verwalten.
Bemerkungen
-
Ruft die nächsten STATPROPSTG-Strukturen ab (die Zahl wird durch den celt-Parameter angegeben). Gibt bei erfolgreicher Ausführung S_OK zurück.
-
Überspringt die Anzahl der in celt angegebenen Elemente. Das nächste Element, das über einen Aufruf von Next aufgezählt werden soll, wird dann zum Element nach den übersprungenen Elementen. Gibt S_OK zurück, wenn Celt-Elemente übersprungen wurden; gibt S_FALSE zurück, wenn weniger als celt-Elemente übersprungen wurden.
-
Legt den Cursor auf den Anfang der Enumeration fest. Bei erfolgreicher Ausführung wird S_OK zurückgegeben, andernfalls wird STG_E_INVALIDHANDLE zurückgegeben.
-
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.
Zugehörige Themen