Msvm_ImageManagementService 类的 AttachVirtualHardDisk 方法

  • 项目

在环回模式下附加虚拟硬盘文件。

语法

uint32 AttachVirtualHardDisk(
  [in]  string              Path,
  [in]  boolean             AssignDriveLetter,
  [in]  boolean             ReadOnly,
  [out] CIM_ConcreteJob REF Job
);

参数

路径 [in]

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

AssignDriveLetter [in]

指示是否将驱动器号分配给磁盘的卷。

ReadOnly [in]

指示附加的硬盘是否应为只读。

作业 [out]

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

返回值

此方法返回以下值之一。

已完成，无错误 (0)

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

( 32768) 失败

拒绝访问 (32769)

不支持 (32770)

状态未知 (32771)

超时 (32772)

参数 (32773) 无效

系统正在使用 (32774)

此操作的无效状态 (32775)

数据类型 (32776) 不正确

系统 ( 32777) 不可用

内存不足 (32778)

(32779) 找不到文件

备注

若要分离虚拟硬盘，请使用 Msvm_MountedStorageImage.DetachVirtualHardDisk 方法。

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

示例

以下 C# 示例演示如何附加虚拟硬盘文件。 可以在 V2) (虚拟化示例的常用实用工具 中找到引用的实用工具。

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

    ManagementBaseObject inParams = imageService.GetMethodParameters("AttachVirtualHardDisk");
    inParams["Path"] = path;
    inParams["AssignDriveLetter"] = true;
    inParams["ReadOnly"] = false;
    ManagementBaseObject outParams = imageService.InvokeMethod("AttachVirtualHardDisk", inParams, null);
    if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
    {
        if (Utility.JobCompleted(outParams, scope))
        {
            Console.WriteLine("{0} was attached successfully.", inParams["Path"]);
        }
        else
        {
            Console.WriteLine("Unable to attach {0}", inParams["Path"]);
        }
    }

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

要求

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

另请参阅

Msvm_MountedStorageImage.DetachVirtualHardDisk

装载 (V1)

Msvm_ImageManagementService