Поделиться через

Метод IVMVirtualMachine::SetActivationValue

  • Статья

[Виртуальный компьютер Windows больше недоступен для использования с Windows 8. Вместо этого используйте поставщик WMI Hyper-V (V2).]

Задает значение указанного параметра активации для этой виртуальной машины.

Синтаксис

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

Параметры

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