Метод IVMVirtualMachine::RemoveActivationValue

  • Статья

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

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

Синтаксис

HRESULT RemoveActivationValue(
  [in] BSTR activationKey
);

Параметры

activationKey [in]

Ключ, используемый для идентификации значения активации, хранящегося в файле "*.vmc".

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Возвращаемый код или значение Описание
S_OK
0
 Операция выполнена успешно.
E_INVALIDARG
0x80000003
 Параметр имеет значение NULL или пусто.
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