Freigeben über


IEnumVdsObject::Clone-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Erstellt eine Enumeration mit demselben Zustand wie die aktuelle Enumeration.

Syntax

HRESULT Clone(
  [out] IEnumVdsObject **ppEnum
);

Parameter

[out] ppEnum

Die Adresse eines IEnumVdsObject-Zeigers , der von VDS bei der Rückgabe initialisiert wird. Aufrufer müssen die Schnittstelle freigeben.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
Die neue Enumeration wurde erstellt.

Hinweise

Mit dieser Methode können Sie einen Punkt in einer Enumeration aufzeichnen und später zu diesem Punkt zurückkehren. Wenn die neue geklonte Enumeration zurückgegeben wird, befindet sie sich am gleichen Punkt in der Enumerationssequenz wie die ursprüngliche. Fortan arbeiten der Klon und die ursprüngliche Enumeration jedoch unabhängig voneinander.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IEnumVdsObject