Метод IVMVirtualPC::SetConfigurationValue

[Виртуальный компьютер 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 (логическое значение).

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

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

Комментарии

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

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

Ключи конфигурации находятся в файле 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"

Требования

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

IVMVirtualPC

IVMVirtualMachine::SetConfigurationValue