ExpandVirtualDisk-Funktion (virtdisk.h)

Erhöht die Größe einer festen oder dynamisch erweiterbaren virtuellen Festplatte (VHD).

Syntax

DWORD ExpandVirtualDisk(
  [in]           HANDLE                          VirtualDiskHandle,
  [in]           EXPAND_VIRTUAL_DISK_FLAG        Flags,
  [in]           PEXPAND_VIRTUAL_DISK_PARAMETERS Parameters,
  [in, optional] LPOVERLAPPED                    Overlapped
);

Parameter

[in] VirtualDiskHandle

Ein Handle für den geöffneten virtuellen Datenträger, der mit dem flag VIRTUAL_DISK_ACCESS_METAOPS geöffnet worden sein muss. Informationen zum Öffnen eines virtuellen Datenträgers finden Sie in der OpenVirtualDisk-Funktion .

[in] Flags

Muss der EXPAND_VIRTUAL_DISK_FLAG_NONE Wert der EXPAND_VIRTUAL_DISK_FLAG-Enumeration sein.

[in] Parameters

Ein Zeiger auf eine gültige EXPAND_VIRTUAL_DISK_PARAMETERS-Struktur , die Erweiterungsparameterdaten enthält.

[in, optional] Overlapped

Ein optionaler Zeiger auf eine gültige OVERLAPPED-Struktur , wenn ein asynchroner Vorgang gewünscht wird.

Rückgabewert

Status der Anforderung.

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode. Weitere Informationen finden Sie unter Systemfehlercodes.

Hinweise

Die Funktion ExpandVirtualDisk führt den Vorgang vor Ort aus und erstellt daher keinen virtuellen Datenträger.

Der Erweiterungsvorgang ist nur für feste und erweiterbare virtuelle Datenträger gültig und führt dazu, dass eine differenzierende virtuelle Datenträgerkette ungültig wird.

Zum Erweitern eines virtuellen Datenträgers muss der virtuelle Datenträger während des Vorgangs getrennt werden.

Der Aufrufer muss ÜBER READ|SCHREIBzugriff auf den Sicherungsspeicher für den virtuellen Datenträger.

Bei einem erweiterbaren virtuellen Datenträger führt die Funktion ExpandVirtualDisk möglicherweise nicht zu einer größeren Datei, da die Größe virtuell ist und erst physisch vergrößert wird, wenn sie verwendet wird.

Wenn der virtuelle Datenträger erweiterbar ist und das Hostvolume nicht über genügend Speicherplatz für die neue Größe verfügt, kann die Funktion ExpandVirtualDisk trotzdem erfolgreich sein. Zukünftige Schreibvorgänge auf den virtuellen Datenträger können fehlschlagen, wenn auf dem Hostvolume bei der Erweiterung des virtuellen Datenträgers nicht genügend Speicherplatz verfügbar ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	virtdisk.h
Bibliothek	VirtDisk.lib
DLL	VirtDisk.dll

Weitere Informationen

Informationen zu VHD

VHD-Referenz