IVdsOpenVDisk::Expand-Methode (vds.h)

Artikel
03/08/2023

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

Erhöht die Größe eines virtuellen Datenträgers auf die maximale Größe, die auf einem festen oder erweiterbaren Datenträger verfügbar ist.

Syntax

HRESULT Expand(
  [in]  EXPAND_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONGLONG                NewSize,
  [out] IVdsAsync                **ppAsync
);

Parameter

[in] Flags

Ein EXPAND_VIRTUAL_DISK_FLAG Enumerationswert, der angibt, wie der virtuelle Datenträger erweitert werden soll. Muss auf EXPAND_VIRTUAL_DISK_FLAG_NONE festgelegt werden.

[in] NewSize

Die gewünschte Größe des erweiterten virtuellen Datenträgers in Bytes.

[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 wird 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 erweitert werden, wenn er getrennt ist.

Der virtuelle Datenträger muss mit Zugriff geöffnet worden sein, um Metadatenvorgänge auszuführen. Dies entspricht dem VIRTUAL_DISK_ACCESS_METAOPS Wert der VIRTUAL_DISK_ACCESS_MASK-Enumeration .

Anforderungen


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

Freigeben über