Msvm_ImageManagementService 类的 ResizeVirtualHardDisk 方法

  • 项目

调整现有虚拟硬盘的大小。 虚拟硬盘必须处于脱机状态。 有关此方法的使用限制，请参阅备注。

语法

uint32 ResizeVirtualHardDisk(
  [in]  string              Path,
  [in]  uint64              MaxInternalSize,
  [out] CIM_ConcreteJob REF Job
);

参数

路径 [in]

类型： 字符串

虚拟硬盘文件的完全限定路径。

MaxInternalSize [in]

类型： uint64

虚拟机可查看的虚拟硬盘的最大大小（以字节为单位）。 MaxInternalSize 最小值为 DiskSize + 512 - (DiskSize mod 512) 。 DiskSize 是虚拟硬盘文件的大小（以字节为单位）。 如果指定的 MaxInternalSize 值小于最小值，则返回 InvalidParameter 错误 (32773) 。

作业 [out]

类型： CIM_ConcreteJob

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

返回值

类型： uint32

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

已完成，无错误 (0)

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

(32768) 失败

访问被拒绝 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 (32773) 无效

系统正在使用 (32774)

此操作的无效状态 (32775)

数据类型 (32776) 不正确

系统 (32777) 不可用

内存不足 (32778)

(32779) 找不到文件

备注

增加虚拟硬盘的大小时，只能将以下类型的虚拟硬盘用于此方法：

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

当虚拟硬盘的大小减小时，只有以下类型的虚拟硬盘才能与此方法一起使用：

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

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

示例

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

const UInt64 size1G = 0x40000000;

public static void ResizeVirtualHardDisk(string path, UInt64 maxInternalSize)
{
    ManagementScope scope = new ManagementScope(@"root\virtualization\V2", null);
    ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");

    ManagementBaseObject inParams = imageService.GetMethodParameters("ResizeVirtualHardDisk");
    inParams["Path"] = path;
    inParams["MaxInternalSize"] = maxInternalSize * size1G;
    ManagementBaseObject outParams = imageService.InvokeMethod("ResizeVirtualHardDisk", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("{0} was resized successfully.", inParams["Path"]);
        }
        else
        {
            Console.WriteLine("Unable to resize {0}", inParams["Path"]);
        }
    }

    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