IVMVirtualMachine：：GetConfigurationValue 方法

  • 项目

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

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

语法

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

parameters

configurationKey [in]

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

configurationValue [out， retval]

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

返回值

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

返回代码/值 说明
S_OK
0
 操作成功。
E_INVALIDARG
0x80000003
 configurationKey 参数为 NULL 或空。
E_POINTER
0x80004003
 configurationValue 参数为 NULL。
VM_E_VM_UNKNOWN
0xA0040207
 配置未知。
VM_E_PREF_NOT_FOUND
0xA0040300
 找不到首选项。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

注解

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

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

例如，若要读取位于以下键树中的“ram_size”键的值：

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

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

"hardware/memory/ram_size"

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

例如，若要读取位于以下键树中的“绝对”键的值：

<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"

要求

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

另请参阅

IVMVirtualMachine