通过

IVMGuestOS：：SetParameter 方法

  • 项目

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

在来宾操作系统中设置命名参数。

语法

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

parameters

inParameterName [in]

参数名称。 它的长度必须介于 1 到 255 个字符之间，并且不能包含反斜杠 (\) 个字符。

inParameterValue [in]

{1}参数值。{2}

返回值

此方法可以返回其中一个值。

返回代码/值 说明
S_OK
0
 操作成功。
E_INVALIDARG
0x80000003
 参数无效或未指定。
VM_E_TIMED_OUT
0xA0040202
 操作未及时完成。
VM_E_VM_NOT_RUNNING
0xA0040206
 虚拟机 (VM) 未运行。
VM_E_VM_PAUSED
0xA00400507
 VM 已暂停。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此 VM 中未安装集成组件。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

备注

调用此方法时，VM 必须正在运行，并且必须安装集成组件。 此方法仅支持基于 Windows 的来宾操作系统。

安装集成组件后，以下项会自动添加到来宾操作系统的注册表：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

当来宾操作系统启动时，将在 Parameters 键中填充以下注册表字符串值：

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
终止客户端支持
 Windows 7
产品
 Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
 IID_IVMGuestOS定义为 99fea0db-4880-499a-b6d8-73dff9bc91be

另请参阅

IVMGuestOS