IVssEnumObject::Next-Methode (vss.h)

  • Artikel

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
S_OK
 Der Vorgang wurde durchgeführt.
S_FALSE
 Die Anzahl der zurückgegebenen Elemente ist kleiner als die angeforderte Anzahl.
E_FAIL
 Im Enumerator liegt ein interner Fehler vor.
E_POINTER
 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

Weitere Informationen

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP