Msvm_ImageManagementService 类的 ValidateVirtualHardDisk 方法

  • 项目

确定虚拟硬盘文件是否有效。

语法

uint32 ValidateVirtualHardDisk(
  [in]  string              Path,
  [out] CIM_ConcreteJob REF Job
);

参数

路径 [in]

类型： 字符串

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

作业 [out]

类型： CIM_ConcreteJob

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

返回值

类型： uint32

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

已完成，无错误 (0)

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

( 32768) 失败

拒绝访问 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 (32773) 无效

系统正在使用 (32774)

此操作的无效状态 (32775)

数据类型 (32776) 不正确

系统 ( 32777) 不可用

内存不足 (32778)

(32779) 找不到文件

检测到 Vhd 差异链周期 (32787)

备注

如果虚拟硬盘是差异磁盘，则会打开整个虚拟磁盘链。 如果在磁盘链中断开链接，则会返回一个作业对象，并初始化相应的错误，并将子属性和父属性初始化到链接断开的位置。

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

示例

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

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

    ManagementBaseObject inParams = imageService.GetMethodParameters("ValidateVirtualHardDisk");
    inParams["Path"] = vhdPath;
    ManagementBaseObject outParams = imageService.InvokeMethod("ValidateVirtualHardDisk", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("{0} is a valid virtual hard disk.", inParams["Path"]);
        }
        else
        {
            Console.WriteLine("Unable to validate {0}", inParams["Path"]);
        }
    }

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

要求

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

另请参阅

ValidateVirtualHardDisk (V1)

CIM_ConcreteJob

Msvm_ImageManagementService