Export (0) Print
Expand All

SetParentVirtualHardDisk method of the Msvm_ImageManagementService class

Hyper-V

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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Namespace

\\Root\Virtualization\V2

MOF

WindowsVirtualization.V2.mof

See also

Msvm_ImageManagementService

 

 

Community Additions

ADD
Show:
© 2014 Microsoft