Msvm_ImageManagementService 类的 GetVirtualHardDiskSettingData 方法
检索与虚拟硬盘文件关联的设置数据。
语法
uint32 GetVirtualHardDiskSettingData(
[in] string Path,
[out] string SettingData,
[out] CIM_ConcreteJob REF Job
);
参数
-
路径 [in]
-
磁盘映像文件的完全限定路径。
-
SettingData [out]
-
如果成功,则接收包含虚拟硬盘设置数据的 Msvm_VirtualHardDiskSettingData 类的嵌入实例。
-
作业 [out]
-
如果异步执行操作,此方法将返回 4096,此参数将包含对派生自 CIM_ConcreteJob 的对象的引用。
返回值
此方法返回以下值之一。
-
已完成,无错误 (0)
-
已检查方法参数 - 作业 启动 (4096)
-
(32768) 失败
-
访问被拒绝 (32769)
-
不支持 (32770)
-
状态未知 (32771)
-
超时 (32772)
-
参数 (32773) 无效
-
系统正在使用 (32774)
-
此操作的无效状态 (32775)
-
数据类型 (32776) 不正确
-
系统 (32777) 不可用
-
内存不足 (32778)
-
(32779) 找不到文件
备注
UAC 筛选可能会限制对 Msvm_ImageManagementService 类的访问。 有关详细信息,请参阅 用户帐户控制和 WMI。
示例
以下 C# 示例演示如何调用 GetVirtualHardDiskState 方法。 可以在 虚拟化示例的常见实用工具中找到引用的实用工具, (V2) 。
public static void GetVirtualHardDiskSettingData(string vhdPath)
{
ManagementScope scope = new ManagementScope(@"root\virtualization\V2", null);
ManagementObject imageService = Utility.GetServiceObject(scope, "Msvm_ImageManagementService");
ManagementBaseObject inParams = imageService.GetMethodParameters("GetVirtualHardDiskSettingData");
inParams["Path"] = vhdPath;
ManagementBaseObject outParams = imageService.InvokeMethod("GetVirtualHardDiskSettingData", inParams, null);
if ((UInt32)outParams["ReturnValue"] == ReturnCode.Started)
{
if (Utility.JobCompleted(outParams, scope))
{
Console.WriteLine("GetVirtualHardDiskSettingData was successful.");
}
else
{
Console.WriteLine("GetVirtualHardDiskSettingData was not successful.");
}
}
else if ((UInt32)outParams["ReturnValue"] == ReturnCode.Completed)
{
string diskStateString = outParams["SettingData"].ToString();
Utility.PrintEmbeddedInstance(diskStateString);
}
outParams.Dispose();
inParams.Dispose();
imageService.Dispose();
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
命名空间 |
Root\Virtualization\V2 |
MOF |
|
DLL |
|