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

Weitere Informationen

Informationen zu VHD

VHD-Referenz