IVMVirtualPC：：SetConfigurationValue 方法

  • 项目

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

设置指定配置设置的值。

语法

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

参数

preferenceKey [in]

用于标识首选项的键，存储在“%LocalAppData%\Microsoft\Windows虚拟电脑”) 中的每用户配置文件 (Options.xml 中。

重要

应仅使用 SetConfigurationValue 方法更改Options.xml。 不支持使用任何其他方法更改Options.xml。

preferenceValue [in]

首选项值。 此值可以是以下 VARIANT 类型之一：VT_ARRAY|VT_UI1 ( (原始字节) 、VT_BSTR字符串) 、VT_UI4 (整数) 或VT_BOOL (布尔) 。

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_POINTER
0x80004003
 preferenceKey 或 preferenceValue 参数为 NULL。
E_INVALIDARG
0x80000003
 preferenceKey 参数无效或为空字符串。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。
E_ACCESSDENIED
0x80070005
 当前用户对配置文件的访问权限不足。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 处理器不支持硬件加速虚拟化 (HAV) 扩展。

注解

preferenceKey 参数支持以下值。

preferenceKey 值 说明 数据类型 默认值
“idle_timeout”
 如果没有使用Windows虚拟电脑接口的活动 VM 或应用程序，vpc.exe应等待的秒数。
 “integer”
 "30"

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

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

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

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

preferenceKey 路径字符串将指定如下：

"idle_timeout"

如果所需树中的任何键具有“id”属性值，则属性及其值会立即嵌入到其关联的配置键之后的 preferenceKey 路径字符串中，格式如下：“[@id=”id_value“]”。

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

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

preferenceKey 路径字符串将指定如下：

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

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
客户端支持结束
 Windows 7
产品
 Windows Virtual PC
标头
VPCOMInterfaces.h
IID
 IID_IVMVirtualPC定义为 236ba0d9-a24a-4292-a132-27c1421dfd01

另请参阅

IVMVirtualPC

IVMVirtualMachine：：SetConfigurationValue