IVMVirtualMachine::GetConfigurationValue 方法

[Windows虚拟电脑自 2012 年 10 月 10 日起不再Windows 8。 请改为将Hyper-V WMI 提供程序 (V2) 。 ]

检索此虚拟机的指定配置设置的值。

语法

HRESULT GetConfigurationValue(
  [in]          BSTR    configurationKey,
  [out, retval] VARIANT *configurationValue
);

parameters

configurationKey []

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

configurationValue [out、retval]

配置值。 此值可以是以下 VARIANT 类型之一 :VT _ ARRAY | VT _ UI1 (原始字节) 、VT _ BSTR (字符串) 、VT _ I4 (整数) 或 VT _ BOOL (布尔) 。

返回值

此方法可以返回这些值之一。

返回代码/值 说明
S _OK
0
操作成功。
E _INVALIDARG
0x80000003
configurationKey 参数为 NULL 或为空。
E _指针
0x80004003
configurationValue 参数为 NULL
VM _E _ _ VM
未知0xA0040207
配置未知。
VM _找不到 _ E _ PREF _ 0xA0040300
找不到首选项。
DISP _E _ EXCEPTION
0x80020009
发生意外错误。

备注

此方法提供对任何配置值的低级别访问。 它可用于读取客户定义的密钥的配置值。

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

例如,读取位于以下密钥树中的"ram _ 大小"键的值:

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

configurationKey 路径字符串的指定方式如下:

"hardware/memory/ram_size"

如果所需树中的任一键具有"id"属性值,则该属性及其值将嵌入 configurationKey 路径字符串中,紧接在其关联的配置键之后,使用括号格式 [ @id :"="id _ 值" ] "。

例如,读取位于以下密钥树中的"绝对"键的值:

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

configurationKey 路径字符串的指定方式如下:

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

要求

要求 Value
最低受支持的客户端
Windows 7 [ 个桌面应用]
最低受支持的服务器
无受支持的版本
客户端支持结束
Windows 7
产品
Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
IID _ IVMVirtualMachine 定义为 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另请参阅

IVMVirtualMachine