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 |