IVMVirtualMachine：：Name 属性

  • 项目

[自 Windows 8 起，Windows 虚拟电脑不再可用。 请改用 Hyper-V WMI 提供程序 (V2) 。]

检索并设置虚拟机配置的名称。

此属性是可读写的。

语法

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

属性值

指定虚拟机配置的名称。 名称长度不能超过 80 个字符，包含虚拟机名称配置文件的完全限定路径的总长度不能超过 MAX_PATH (260) 个字符。

错误代码

名称/值 含义
S_OK
0
 操作成功。
E_POINTER
0x80004003
 参数为 NULL。
E_INVALIDARG
0x80000003
 参数无效或为空字符串。
VM_E_VM_UNKNOWN
0xA0040207
 配置未知。
VM_E_PREF_VM_ACTIVE
0xA0040302
 虚拟机正在运行或已保存。
VM_E_CONFIG_NO_NAME
0xA0040400
 virtualMachineName 参数为空。
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 参数包含的字符过多。
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 参数包含以下无效字符“*？：<>/|\”之一。
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 指定的名称已作为另一个虚拟机的名称存在。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

备注

虚拟机名称不区分大小写，例如“MyVM”和“myvm”是指同一虚拟机。 这是 IVMVirtualMachine 的默认属性。

如果VPC.exe正在运行并且 VM 已保存，则设置 Name 属性将不会成功。 如果VPC.exe未运行并且 VM 已保存，则在下次启动VPC.exe时，设置 Name 属性将成功。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
终止客户端支持
 Windows 7
产品
 Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
 IID_IVMVirtualMachine定义为 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另请参阅

IVMVirtualMachine