AddVirtualDiskParent function

Attaches a parent to a virtual disk opened with the OPEN_VIRTUAL_DISK_FLAG_CUSTOM_DIFF_CHAIN flag.


DWORD AddVirtualDiskParent(
  HANDLE VirtualDiskHandle,
  PCWSTR ParentPath



Handle to a virtual disk.


Address of a string containing a valid path to the virtual hard disk image to add as a parent.

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.


This adds the specified parent virtual hard disk to the head of the differencing chain of the specified virtual hard disk. If the differencing chain extends beyond the parent, this function can be called repeatedly to add additional parents to the differencing chain.


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