IVMVirtualMachine：：SetActivationValue 方法

  • 项目

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

设置此虚拟机的指定激活设置的值。

语法

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

parameters

activationKey [in]

用于标识存储在“*.vmc”文件中的激活值的密钥。

activationValue [in]

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

返回值

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

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

备注

此方法提供对任何激活值的低级别访问。 它可用于设置客户定义的密钥的激活值。 如果使用此方法设置系统激活值，请小心，因为不会对激活值执行错误检查。 此外，某些激活值在虚拟机运行时无法更改。 启动虚拟机时，会复制其配置值，该配置值将成为其激活值集。 在关闭或重启虚拟机之前，将保留激活值。 请注意，Windows 虚拟电脑可能仅使用配置来存储某些密钥的值，也就是说，可能永远不会使用激活值。

注意

必须先运行虚拟机会话，然后才能更改任何激活值。

激活密钥以类似于 Windows 中的注册表项的分层方式存储在内部。 若要指定特定的子项，请构造一个“键路径”，以斜杠标记分隔格式指定各种键。

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

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

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

"settings/undo_drives/default_action"

要求

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

另请参阅

IVMVirtualMachine