Msvm_ImageManagementService 类的 MergeVirtualHardDisk 方法

  • 项目

将差异链中的子虚拟硬盘与链中的一个或多个父虚拟硬盘合并。 有关此方法的使用限制，请参阅备注。

如果执行此函数的用户无权更新虚拟机，则此函数将失败。

语法

uint32 MergeVirtualHardDisk(
  [in]  string              SourcePath,
  [in]  string              DestinationPath,
  [out] CIM_ConcreteJob REF Job
);

parameters

SourcePath [in]

类型： 字符串

一个完全限定的路径，指定要合并的虚拟硬盘文件的位置。

DestinationPath [in]

类型： 字符串

一个完全限定的路径，指定要将数据合并到其中的父虚拟硬盘文件的位置。 这可能是合并文件的直接父虚拟硬盘，也可以是差异链上几个级别的父磁盘映像。

作业 [out]

类型： CIM_ConcreteJob

如果异步执行操作，此方法将返回 4096，此参数将包含对派生自 CIM_ConcreteJob 的对象的引用。

返回值

类型： uint32

此方法可以返回以下值之一。

已完成，无错误 (0)

已检查方法参数 - 作业 启动 (4096)

(32768) 失败

访问被拒绝 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 (32773) 无效

系统正在使用 (32774)

此操作的无效状态 (32775)

数据类型 (32776) 不正确

系统 (32777) 不可用

内存不足 (32778)

(32779) 找不到文件

备注

子虚拟硬盘必须处于脱机状态。

只有以下类型的虚拟硬盘可以与此方法一起使用：

  • 差异 VHD
  • 差异 VHDX

UAC 筛选可能会限制对 Msvm_ImageManagementService 类的访问。 有关详细信息，请参阅 用户帐户控制和 WMI。

示例

以下 C# 示例扩展了虚拟硬盘文件。 可以在 虚拟化示例的常见实用工具中找到引用的实用工具， (V2) 。

// Merges a VHD into a parent VHD.
// ChildPath: The path to the VHD to merge.</param>
// ParentPath: The path to the parent into which to merge.</param>
public static void MergeVirtualHardDisk(string ChildPath, string ParentPath)
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\v2", null);
    ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");

    ManagementBaseObject inParams = imageService.GetMethodParameters("MergeVirtualHardDisk");

    inParams["SourcePath"] = ChildPath;
    inParams["DestinationPath"] = ParentPath;

    ManagementBaseObject outParams = imageService.InvokeMethod("MergeVirtualHardDisk", inParams, null);

    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("MergeVirtualHardDisk succeeded.");
        }
        else
        {
            Console.WriteLine("MergeVirtualHardDisk failed.");
        }
    }

    outParams.Dispose();
    inParams.Dispose();
    imageService.Dispose();
}

要求

要求 值
最低受支持的客户端
 Windows 8 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2012 [仅限桌面应用]
命名空间
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

请参阅

CIM_ConcreteJob

Msvm_ImageManagementService