Метод IVMVirtualMachine::SetConfigurationValue

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

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

Синтаксис

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

Параметры

configurationKey [in]

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

Важно!

Изменения следует вносить в "*.vmc" только с помощью метода SetConfigurationValue . Изменение "*.vmc" с помощью любого другого метода не поддерживается.

configurationValue [in]

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

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

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

Возвращаемый код или значение	Описание
S_OK 0	Операция выполнена успешно.
E_INVALIDARG 0x80000003	Параметр configurationKey имеет значение NULL или пустой, или параметр configurationValue не является допустимым типом варианта.
VM_E_VM_UNKNOWN 0xA0040207	Конфигурация неизвестна.
DISP_E_EXCEPTION 0x80020009	Произошла непредвиденная ошибка.

Комментарии

Для параметра configurationKey поддерживаются следующие значения.

значение configurationKey	Описание	Тип данных	Значение по умолчанию
"hardware/bios/time_sync_at_boot"	"true", если часы CMOS виртуальной машины должны быть синхронизированы с часами узла при загрузке; "false" в противном случае.	"boolean"	True
"integration/microsoft/host_time_sync/enabled""	"true", если синхронизация времени узла включена в компонентах интеграции; "false" в противном случае.	"boolean"	True
"ui_options/auto_app_publish"	"true", если автоматическая публикация приложений включена в компонентах интеграции; "false" в противном случае. Это также называется виртуальными приложениями.	"boolean"	True
"ui_options/seconds_to_save"	Время ожидания перед сохранением виртуальной машины после закрытия всех приложений в секундах. Однако значения ниже 20 и более 4 294 968 имеют особые значения. Дополнительные сведения см. в следующем списке. 0 Никогда не сохраняйте виртуальную машину. 1 20 Подождите 20 секунд, прежде чем сохранить виртуальную машину. 21 4,294,967 Подождите указанное количество секунд перед сохранением виртуальной машины. 4,294,968 4,294,967,295 Подождите 4 294 968 секунд, прежде чем сохранить виртуальную машину.	"integer"	300

Этот метод обеспечивает низкоуровневый доступ к любому значению конфигурации. Его можно использовать для задания значений конфигурации для ключей, определяемых клиентом. Будьте внимательны, если этот метод используется для задания значений конфигурации системы, так как проверка ошибок не выполняется для значения конфигурации. Кроме того, некоторые значения конфигурации нельзя изменить во время работы виртуальной машины.

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

Например, чтобы задать значение ключа "ram_size", расположенного в следующем дереве ключей:

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

Строка пути configurationKey будет указана следующим образом:

"hardware/memory/ram_size"

Если какой-либо из ключей в требуемом дереве имеет значение атрибута id, атрибут и его значение внедряются в строку пути configurationKey сразу после связанного ключа конфигурации в следующем формате в квадратных скобках: "[@id="id_value"]".

Например, чтобы задать значение клавиши golf, расположенной в следующем дереве ключей:

<preferences>
  <alpha>
    <bravo>
      <charlie>
        <delta id="1">
          <echo id="0">
            <foxtrot>
              <golf type="string">D</golf>

Строка пути configurationKey будет указана следующим образом:

"alpha/bravo/charlie/delta[@id=1]/echo[@id=0]/foxtrot/golf"

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Окончание поддержки клиентов	Windows 7
Продукт	Windows Virtual PC
Заголовок	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachine определяется как f7092aa1-33ed-4f78-a59f-c00adfc2edd7

См. также раздел

IVMVirtualMachine

IVMVirtualPC::SetConfigurationValue