SetVirtualDiskMetadata-Funktion (virtdisk.h)

Artikel
03/06/2024

Legt ein Metadatenelement für einen virtuellen Datenträger fest.

Syntax

DWORD SetVirtualDiskMetadata(
  [in] HANDLE     VirtualDiskHandle,
  [in] const GUID *Item,
  [in] ULONG      MetaDataSize,
  [in] const void *MetaData
);

Parameter

[in] VirtualDiskHandle

Handle mit einem geöffneten virtuellen Datenträger.

[in] Item

Adresse einer GUID , die die festzulegenden Metadaten identifiziert. Dies kann nicht die NULL-GUID (eine GUID aller Nullen) sein.

[in] MetaDataSize

Adresse eines ULONG-Elements , das die Größe des Puffers in Bytes enthält, auf den der MetaData-Parameter verweist. Bestimmte VHD-Dateitypen weisen eine maximale Größe pro Metadatenelement auf. Bestimmte VHD-Dateien weisen auch eine maximale Anzahl von Metadateneinträgen und die Gesamtgröße der Metadaten auf.

[in] MetaData

Adresse des Puffers, der die zu speichernden Metadaten enthält.

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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	virtdisk.h (einschließlich Windows.h)
Bibliothek	VirtDisk.lib
DLL	VirtDisk.dll

Weitere Informationen

VHD-Funktionen

Share via