IVssEnumObject::Next-Methode (vss.h)
Die Next-Methode gibt die angegebene Anzahl von Objekten aus der angegebenen Liste der aufgezählten Objekte zurück.
Syntax
HRESULT Next(
[in] ULONG celt,
[out] VSS_OBJECT_PROP *rgelt,
[out] ULONG *pceltFetched
);
Parameter
[in] celt
Die Anzahl der Elemente, die aus der Liste der aufgezählten Objekte in den rgelt-Puffer gelesen werden sollen.
[out] rgelt
Die Adresse eines vom Aufrufer zugewiesenen Puffers, der celtVSS_OBJECT_PROP Strukturen empfängt, die die zurückgegebenen Objekte enthalten. Dieser Parameter ist erforderlich und darf nicht NULL sein.
[out] pceltFetched
Die Anzahl der Elemente, die im rgelt-Puffer zurückgegeben wurden.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Anzahl der zurückgegebenen Elemente ist kleiner als die angeforderte Anzahl. |
|
Im Enumerator liegt ein interner Fehler vor. |
|
Einer der erforderlichen Zeigerparameter ist NULL. |
Hinweise
Beim Anfordern der Rückgabe von mehr als einem VSS_OBJECT_PROP-Objekts gibt ein Rückgabewert von S_FALSE an, dass das Ende der Enumerationsliste erreicht wurde. Wenn mehr Objekte angefordert wurden, als in der Liste verblieben sind, gibt Next alle verbleibenden Objekte zurück, legt den parameter pceltFetched auf einen Nonzero-Wert fest und gibt S_FALSE zurück.
Der Ausgabe-rgelt-Parameter muss auf ein zugeordnetes Array verweisen, das celtVSS_OBJECT_PROP-Strukturen enthält, und darf nicht NULL sein.
Es liegt in der Verantwortung des Aufrufers, Systemressourcen freizugeben, die von IVssEnumObject::Neben der VSS_OBJECT_PROP Struktur zurückgegeben werden, auf die der rgelt-Parameter verweist.
Die Aufrufer müssen CoTaskMemFree für jeden Zeichenfolgenwert im VSS_SNAPSHOT_PROP - oder VSS_PROVIDER_PROP -Objekt in der zurückgegebenen VSS_OBJECT_PROP-Struktur verwenden.
Bei VSS_SNAPSHOT_PROP kann dies manuell erfolgen, oder die Hilfsprogrammfunktion VssFreeSnapshotProperties kann verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vss.h |
| Bibliothek | VssApi.lib |