IVMVirtualMachine：：SetConfigurationValue 方法

  • 项目

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

设置此虚拟机 (VM) 的指定配置设置的值。

语法

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

参数

configurationKey [in]

用于标识存储在“*.vmc”文件中的配置值的键。

重要

应仅使用 SetConfigurationValue 方法对“*.vmc”进行更改。 不支持使用任何其他方法更改“*.vmc”。

configurationValue [in]

配置值。 此值为下列 VARIANT 类型之一： VT_ARRAY|VT_UI1 (原始字节) 、 VT_BSTR (字符串) 、 VT_UI4 (整数) 或 VT_BOOL (布尔) 。

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_INVALIDARG
0x80000003
 configurationKey 参数为 NULL 或空，或者 configurationValue 参数不是有效的变体类型。
VM_E_VM_UNKNOWN
0xA0040207
 配置未知。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

备注

configurationKey 参数支持以下值。

configurationKey 值 说明 数据类型 默认值
“hardware/bios/time_sync_at_boot”
 “true”（如果 VM 的 AZURE 时钟将在启动时与主机时钟同步）;否则为“false”。
 "boolean"
 “true”
“integration/microsoft/host_time_sync/enabled””
 如果在集成组件中启用了主机时间同步，则为 “true”;否则为“false”。
 "boolean"
 “true”
“ui_options/auto_app_publish”
 如果在集成组件中启用了应用程序的自动发布，则为 “true”;否则为“false”。 这也称为虚拟应用程序。
 "boolean"
 “true”
“ui_options/seconds_to_save”
 关闭所有应用程序后保存 VM 之前等待的秒数。 但是，小于 20 且大于 4，294，968 的值具有特殊含义。 有关详细信息，请参阅以下列表
0
永远不要保存 VM。
1 20
等待 20 秒，然后保存 VM。
21 4,294,967
等待指定的秒数，然后保存 VM。
4,294,968 4,294,967,295
等待 4，294，968 秒，然后保存 VM。
 “integer”
 300

此方法提供对任何配置值的低级别访问。 它可用于设置客户定义的密钥的配置值。 如果使用此方法设置系统配置值，请小心，因为不会对配置值执行错误检查。 此外，在虚拟机运行时，某些配置值无法更改。

配置密钥位于虚拟机的“*.vmc”文件中，该文件采用 XML 格式。 这些密钥以类似于 Windows 中的注册表项的分层方式存储。 若要指定特定的子项，请构造一个“键路径”，该路径以斜杠分隔格式指定各种键。

例如，设置位于以下键树中的“ram_size”键的值：

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

将按如下所示指定 configurationKey 路径字符串：

"hardware/memory/ram_size"

如果所需树中的任何键具有“id”属性值，则属性及其值将立即嵌入在其关联配置键后面的 configurationKey 路径字符串中，并使用以下方括号格式：“[@id=”id_value“]”。

例如，设置位于以下键树中的“golf”键的值：

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

将按如下所示指定 configurationKey 路径字符串：

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

要求

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

另请参阅

IVMVirtualMachine

IVMVirtualPC：：SetConfigurationValue