SetParentVirtualHardDisk method of the Msvm_ImageManagementService class
Updates the parent for the specified leaf and child virtual hard disk files. See Remarks for usage restrictions for this method.
Syntax
uint32 SetParentVirtualHardDisk(
[in] string ChildPath,
[in] string ParentPath,
[in] string LeafPath,
[in] boolean IgnoreIDMismatch,
[out] CIM_ConcreteJob REF Job
);
Parameters
-
ChildPath [in]
-
A fully qualified path that specifies the location of the child virtual hard disk file.
-
ParentPath [in]
-
A fully qualified path that specifies the location of the parent virtual hard disk file.
-
LeafPath [in]
-
A fully qualified path that specifies the location of the leaf virtual hard disk file. The parameter can be Null if the virtual hard disk is offline, but must be specified if the virtual hard disk is in use.
-
IgnoreIDMismatch [in]
-
Indicates if the parent should be forcibly set when the virtual disk identifiers do not match. This parameter must be used with caution because if the new parent virtual hard disk is not identical to the original parent, data corruption can occur.
-
Job [out]
-
If the operation is performed asynchronously, this method will return 4096, and this parameter will contain a reference to an object derived from CIM_ConcreteJob.
Return value
This method returns one of the following values.
-
Completed with No Error (0)
-
Method Parameters Checked - Job Started (4096)
-
Failed (32768)
-
Access Denied (32769)
-
Not Supported (32770)
-
Status is unknown (32771)
-
Timeout (32772)
-
Invalid parameter (32773)
-
System is in use (32774)
-
Invalid state for this operation (32775)
-
Incorrect data type (32776)
-
System is not available (32777)
-
Out of memory (32778)
-
File not found (32779)
Remarks
Only the following types of virtual hard disks can be used with this method:
- Differencing VHD
- Differencing VHDX
Access to the Msvm_ImageManagementService class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 8 [desktop apps only] |
| Minimum supported server |
Windows Server 2012 [desktop apps only] |
| Namespace |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|