CIM_VirtualSystemMigrationService 类的 CheckVirtualSystemIsMigratableToHost 方法

执行预检查的方法,以确定虚拟系统是否可能成功迁移到由网络名称或 IP 地址指定的目标主机。 由于动态资源可用性,此方法不保证后续迁移始终成功。

返回代码说明:

注意:此方法仅在群集支持建模可用之前用作过渡解决方案。

语法

uint32 CheckVirtualSystemIsMigratableToHost(
  [in]  CIM_ComputerSystem REF ComputerSystem,
  [in]  string                 DestinationHost,
  [in]  string                 MigrationSettingData,
  [in]  string                 NewSystemSettingData,
  [in]  string                 NewResourceSettingData[],
  [out] boolean                IsMigratable
);

参数

ComputerSystem [in]

对要迁移的源虚拟计算机系统的 CIM_ComputerSystem 引用。

DestinationHost [in]

迁移的目标主机系统。

此参数的可接受格式通过通过CIM_ElementCapabilities关联关联的CIM_VirtualSystemMigrationCapabilities实例中的 DestinationHostFormatsSupported[ ] 数组属性的元素值来传达。

MigrationSettingData [in]

包含表示适用于迁移操作的迁移设置的 CIM_VirtualSystemMigrationSettingData 类的嵌入实例的字符串。

NewSystemSettingData [in]

包含 CIM_VirtualSystemSettingData 类的嵌入实例的字符串,表示迁移后适用于虚拟系统的新属性。

NewResourceSettingData [in]

每个字符串数组都包含 CIM_ResourceAllocationSettingData 类的嵌入实例,表示迁移后适用于虚拟系统范围内的虚拟资源的新属性。

IsMigratable [out]

迁移检查指示是否可以成功迁移虚拟系统的结果。

返回值

成功时返回 0;否则,将返回错误。

返回代码/值 说明
已完成,无错误
0
已执行的检查;结果通过 [Out] IsMigratable 参数的值报告。
不支持
1
实现不支持的方法。 未通过 [Out] IsMigratable 参数的值报告任何结果。
已失败
2
由于未指定的原因,检查失败。 未通过 [Out] IsMigratable 参数的值报告任何结果。
超时
3
检查超时。未通过 [Out] IsMigratable 参数的值报告任何结果。
参数无效
4
一个或多个参数正式无效。 例如, DestinationHost 参数的值可能已指定为不支持的格式。 未通过 [Out] IsMigratable 参数的值报告任何结果。
状态无效
5
源虚拟系统、源主机系统或目标主机系统处于允许启动所请求虚拟系统迁移的状态;这可能是一个临时情况。 未通过 [Out] IsMigratable 参数的值报告任何结果。
不兼容的参数
6
一个或多个输入参数作为一组或与目标主机不兼容。 例如, MigrationNewSettingData 参数的值包含由 DestinationHost 参数的值标识的目标主机系统不支持的属性。 未通过 [Out] IsMigratable 参数的值报告任何结果。
DMTF 保留
..
方法保留
4097..32767
供应商特定
32768..65535

要求

要求
最低受支持的客户端
Windows 8.1
最低受支持的服务器
Windows Server 2012 R2
命名空间
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

CIM_VirtualSystemMigrationService