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

See also

Msvm_ImageManagementService