Метод IVMVirtualMachine::GetActivationValue

  • Статья

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

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

Синтаксис

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

Параметры

activationKey [in]

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

activationValue [out, retval]

Значение активации. Это значение может быть одного из следующих типов VARIANT : VT_ARRAY | VT_UI1 (необработанные байты), VT_BSTR (строка), VT_I4 (целое число) или VT_BOOL (логическое значение).

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

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

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