IVdsOpenVDisk::Merge-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.]

Führt einen untergeordneten virtuellen Datenträger mit seinen übergeordneten Datenträgern in der differenzierenden Kette zusammen.

Syntax

HRESULT Merge(
  [in]  MERGE_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                   MergeDepth,
  [out] IVdsAsync               **ppAsync
);

Parameter

[in] Flags

Ein MERGE_VIRTUAL_DISK_FLAG Enumerationswert, der angibt, wie der virtuelle Datenträger zusammengeführt werden soll. Muss auf MERGE_VIRTUAL_DISK_FLAG_NONE festgelegt werden.

[in] MergeDepth

Die Anzahl der übergeordneten Datenträger in der Differenzierungskette, die zusammengeführt werden sollen. Der Datenträger muss mit einem ReadWriteDepth geöffnet worden sein, der mindestens diesem Wert entspricht.

[out] ppAsync

Ein Zeiger auf eine IVdsAsync-Schnittstelle , die nach erfolgreichem Abschluss die IVdsAsync-Schnittstelle empfängt, um diesen Vorgang zu überwachen und zu steuern. Aufrufer müssen die empfangene Schnittstelle freigeben, wenn sie damit fertig sind. Wenn die IVdsAsync::Wait-Methode für die Schnittstelle aufgerufen und ein erfolgreicher HRESULT-Wert zurückgegeben wird, müssen die in der VDS_ASYNC_OUTPUT-Struktur zurückgegebenen Schnittstellen durch Aufrufen der IUnknown::Release-Methode für jeden Schnittstellenzeiger freigegeben werden. Wenn Wait jedoch einen Fehler-HRESULT-Wert zurückgibt oder wenn der pHrResult-Parameter von Wait einen Fehler-HRESULT-Wert empfängt, sind die Schnittstellenzeiger in der VDS_ASYNC_OUTPUT Struktur NULL und müssen nicht freigegeben werden. Sie können mit den in Winerror.h definierten Makros SUCCEEDED und FAILED auf Erfolg oder Fehler HRESULT-Werte testen.

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 Methode wurde erfolgreich abgeschlossen.

Bemerkungen

Ein virtueller Datenträger kann nur zusammengeführt werden, wenn er getrennt ist.

Diese Methode verschiebt alle Datenblöcke vom untergeordneten Datenträger auf den übergeordneten Datenträger. Die ungültigen untergeordneten Datenträger werden am Ende des Vorgangs jedoch nicht gelöscht.

Der virtuelle Datenträger muss mit Lese-/Schreibzugriff geöffnet worden sein.

Anforderungen

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

Weitere Informationen

IVdsOpenVDisk