IVMHardDisk::MergeTo method
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Merges a differencing virtual hard disk with all of its parents (up to and including the root parent virtual hard disk) to a new hard disk file.
Syntax
HRESULT MergeTo(
[in] BSTR newDiskImagePath,
[in] VMHardDiskType newDiskImageType,
[out, retval] IVMTask **mergeTask
);
Parameters
-
newDiskImagePath [in]
-
The path to the new target disk image where the selected disk images will be merged.
-
newDiskImageType [in]
-
The type of new target disk image. The image types allowed for the new target disk image are vmDiskType_Dynamic and vmDiskType_FixedSize. For more information, see VMHardDiskType.
-
mergeTask [out, retval]
-
An IVMTask object that is used to track the completion of the merging process.
Return value
This method can return one of these values.
Return code/value | Description |
---|---|
|
The operation was successful. |
|
A parameter is NULL. |
|
The newDiskImagePath parameter is empty. |
|
The system cannot find the file specified by the newDiskImagePath parameter. |
|
The system cannot find the path specified by the newDiskImagePath parameter. |
|
The newDiskImagePath parameter contains an invalid character (one of the following: "*?<>/|":"). |
|
The newDiskImagePath parameter specifies an empty or relative path. An absolute path is required. |
|
The path specified by the newDiskImagePath parameter is too long. The path must be less than 260 characters. |
|
Either the virtual hard disk referenced by this object is in use or the parent of this virtual hard disk is in use. |
|
This error is caused either because the virtual hard disk image referenced by this IVMHardDisk object is not a differencing disk image or because the parameter newDiskImageType is not one of the accepted values, vmDiskType_Dynamic or vmDiskType_FixedSize. |
|
The file referenced by the newDiskImagePath parameter already exists. |
|
The host volume does not have enough space to merge this virtual hard disk. |
|
The parent of the virtual hard disk referenced by this object does not exist. |
|
The virtual hard disk image cannot be merged because the application is shutting down. |
|
An unexpected error has occurred. |
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows 7 [desktop apps only] |
Minimum supported server |
None supported |
End of client support |
Windows 7 |
Product |
Windows Virtual PC |
Header |
|
IID |
IID_IVMHardDisk is defined as ffa14ae6-48f5-42a4-8a22-186f2e5c7db0 |
See also
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για