AddVirtualDiskParent function (virtdisk.h)

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

Syntax

DWORD AddVirtualDiskParent(
  [in] HANDLE VirtualDiskHandle,
  [in] PCWSTR ParentPath
);

Parameters

[in] VirtualDiskHandle

Handle to a virtual disk.

[in] ParentPath

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.

Remarks

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.

Requirements

Requirement Value
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