SetVirtualDiskMetadata function

Sets a metadata item for a virtual disk.

Syntax

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

Parameters

VirtualDiskHandle

Handle to an open virtual disk.

Item

Address of a GUID identifying the metadata to retrieve.

MetaDataSize

Address of a ULONG containing the size, in bytes, of the buffer pointed to by the MetaData parameter.

MetaData

Address of the buffer containing the metadata to be stored.

Return Value

Status of the request.

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is an error code. For more information, see System Error Codes.

Requirements

   
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Windows
Header virtdisk.h (include Windows.h)
Library VirtDisk.lib
DLL VirtDisk.dll

See Also

VHD Functions