SetVirtualDiskMetadata-Funktion (virtdisk.h)

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

Weitere Informationen

VHD-Funktionen