Msvm_ImageManagementService 类的 CompactVirtualHardDisk 方法

  • 项目

压缩虚拟硬盘文件。 压缩是释放虚拟硬盘未使用部分的过程。 虚拟硬盘不会自动装载。 有关此方法的使用限制，请参阅说明。

语法

uint32 CompactVirtualHardDisk(
  [in]  string              Path,
  [in]  uint16              Mode,
  [out] CIM_ConcreteJob REF Job
);

参数

路径 [in]

类型： 字符串

一个指定合并文件位置的完全限定路径。

模式 [in]

类型： uint16

指定压缩操作的模式。 这必须是以下值之一。

完整 (0)

快速 (1)

retrim (2)

预压缩 (3)

预零 (4)

作业 [out]

类型： CIM_ConcreteJob

如果任务) 完成，对作业 (的引用可以为 Null 。

返回值

类型： uint32

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

已完成，无错误 (0)

方法参数已选中 - 作业已启动 (4096)

( 32768) 失败

拒绝访问 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 (32773) 无效

系统正在使用 (32774)

此操作的无效状态 (32775)

数据类型 (32776) 不正确

系统 ( 32777) 不可用

内存不足 (32778)

(32779) 找不到文件

备注

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

  • 修复了 VHDX
  • 动态 VHD
  • 动态 VHDX
  • 差异 VHD
  • 差异 VHDX

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

示例

以下 C# 示例压缩虚拟硬盘。 可以在 V2) (虚拟化示例的常用实用工具 中找到引用的实用工具。

public enum VirtualHardDiskCompactMode
{
    Full = 0,
    Quick = 1,
    Retrim = 2,
    Pretrimmed = 3,
    Prezeroed = 4
}

public static void CompactVirtualHardDisk(string vhdPath, VirtualHardDiskCompactMode compactMode)
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\v2", null);
    ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");

    ManagementBaseObject inParams = imageService.GetMethodParameters("CompactVirtualHardDisk");
    inParams["Path"] = vhdPath;
    inParams["Mode"] = compactMode;
    ManagementBaseObject outParams = imageService.InvokeMethod("CompactVirtualHardDisk", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("{0} was compacted successfully.", inParams["Path"]);
        }
        else
        {
            Console.WriteLine("Unable to compact {0}", inParams["Path"]);
        }
    }
    else
    {
        Console.WriteLine("Compact {0} returned error {1}", inParams["Path"], outParams["ReturnValue"]);
    }

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

要求

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

另请参阅

CIM_ConcreteJob

Msvm_ImageManagementService