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 |