IVdsPack::ReplaceDisk-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.]

Wird nicht unterstützt.

Diese Methode ist für eine spätere Verwendung vorgesehen.

Syntax

HRESULT ReplaceDisk(
  [in]  VDS_OBJECT_ID OldDiskId,
  [in]  VDS_OBJECT_ID NewDiskId,
  [out] IVdsAsync     **ppAsync
);

Parameter

[in] OldDiskId

Die GUID des alten Datenträgers.

[in] NewDiskId

Die GUID des neuen Datenträgers.

[out] ppAsync

Die Adresse eines IVdsAsync-Schnittstellenzeigers , der von VDS bei der Rückgabe initialisiert wird. Aufrufer müssen die Schnittstelle freigeben. Verwenden Sie diese Schnittstelle, um den status des Vorgangs abzubrechen, abzuwarten oder abzufragen.

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.

Hinweise

Aufrufer können diese Methode für die Medienmigration (Ersetzen eines alten Datenträgers durch einen neuen Datenträger) oder beim Reparieren einer fehlertoleranten Gruppe mit einem fehlenden oder fehlerhaften Member verwenden – insbesondere für anbieter, die keine Hot-Sparing-Instanz implementieren.

Der neue Datenträger muss sich im selben Paket wie der alte Datenträger befinden und darf keine Daten enthalten. Es kann den falschen Partitionierungsstil aufweisen. Bei erfolgreicher Ersetzung behält der alte Datenträger die Partitionierungsart bei, aber keine gültigen Volumes.

Implementer müssen einen Zeiger auf die IVdsAsync-Schnittstelle für diese Methode zurückgeben, unabhängig davon, ob der Aufruf einen asynchronen Vorgang initiiert. Wenn Ihr Anbieter hot sparing nicht implementiert, muss er das Fehlerelementszenario unterstützen: Starten Sie die Synchronisierung des verfügbar gemachten fehlertoleranten Volumes erneut, nachdem der Aufrufer die ReplaceDisk-Methode aufgerufen hat.

Anforderungen