SetVirtualDiskInformation-Funktion (virtdisk.h)
Legt Informationen zu einer virtuellen Festplatte (VHD) fest.
Syntax
DWORD SetVirtualDiskInformation(
[in] HANDLE VirtualDiskHandle,
[in] PSET_VIRTUAL_DISK_INFO VirtualDiskInfo
);
Parameter
[in] VirtualDiskHandle
Ein Handle für den geöffneten virtuellen Datenträger, der mit dem VIRTUAL_DISK_ACCESS_METAOPS-Flag geöffnet worden sein muss. Informationen zum Öffnen eines virtuellen Datenträgers finden Sie in der OpenVirtualDisk-Funktion .
[in] VirtualDiskInfo
Ein Zeiger auf eine gültige SET_VIRTUAL_DISK_INFO-Struktur .
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 SetVirtualDiskInformation-Funktion schlägt fehl, wenn der ParentFilePath-Member festgelegt werden soll, das System den angegebenen Pfad jedoch nicht auflösen kann.
Das Festlegen der übergeordneten Informationen führt auch dazu, dass die übergeordneten GUID - und Zeitstempelfelder des Untergeordneten aktualisiert werden.
Der virtuelle Datenträger kann nicht angefügt werden, während dieser Vorgang ausgeführt wird.
Der Aufrufer muss über READ|SCHREIBzugriff auf den Sicherungsspeicher für den virtuellen Datenträger.
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 |