Метод IVMVirtualPC::SetConfigurationValue

Статья
06/13/2023

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

Задает значение указанного параметра конфигурации.

Синтаксис

HRESULT SetConfigurationValue(
  [in] BSTR    preferenceKey,
  [in] VARIANT preferenceValue
);

Параметры

preferenceKey [in]: Ключ, используемый для определения предпочтения, который хранится в файле конфигурации для каждого пользователя (Options.xml в "%LocalAppData%\Microsoft\Windows Virtual PC").

Важно!

Изменения следует вносить в Options.xml только с помощью метода SetConfigurationValue . Изменение Options.xml с помощью любого другого метода не поддерживается.
preferenceValue [in]: Значение предпочтения. Это значение может быть одного из следующих типов VARIANT : VT_ARRAY|VT_UI1 (необработанные байты), VT_BSTR (строка), VT_UI4 (целое число) или VT_BOOL (логическое значение).

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

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

Возвращаемый код/значение	Описание
S_OK 0	Операция выполнена успешно.
E_POINTER 0x80004003	Параметр preferenceKey или preferenceValue имеет значение NULL.
E_INVALIDARG 0x80000003	Параметр preferenceKey недопустим или является пустой строкой.
DISP_E_EXCEPTION 0x80020009	Произошла непредвиденная ошибка.
E_ACCESSDENIED 0x80070005	Текущий пользователь имеет недостаточный доступ к файлу конфигурации.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Процессор не поддерживает расширения аппаратной ускоренной виртуализации (HAV).

значение preferenceKey	Описание	Тип данных	Значение по умолчанию
"idle_timeout"	Количество секунд, в течение которых vpc.exe должны ждать перед выходом, если нет активных виртуальных машин или приложений, использующих интерфейсы виртуального компьютера Windows.	"целое число"	"30"

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

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

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

<preferences>
  <idle_timeout type="integer">60</idle_timeout>

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

"idle_timeout"

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Окончание поддержки клиентов	Windows 7
Продукт	Windows Virtual PC
Заголовок	VPCCOMInterfaces.h
IID	IID_IVMVirtualPC определяется как 236ba0d9-a24a-4292-a132-27c1421dfd01

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

IVMVirtualPC
IVMVirtualMachine::SetConfigurationValue