IVMVirtualPC::SetConfigurationValue-Methode

Artikel
09/21/2022

[Windows Virtual PC ist nicht mehr für die Verwendung als Windows 8 verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Legt den Wert der angegebenen Konfigurationseinstellung fest.

Syntax

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

Parameter

preferenceKey [in]: Der Schlüssel, der zum Identifizieren der Einstellung verwendet wird, wie in der Konfigurationsdatei pro Benutzer gespeichert (Options.xml in "%LocalAppData%\Microsoft\Windows Virtual PC").

Wichtig

Änderungen sollten an Options.xml nur mithilfe der SetConfigurationValue-Methode vorgenommen werden. Das Ändern Options.xml mit einer anderen Methode wird nicht unterstützt.
preferenceValue [in]: Der Einstellungswert. Dieser Wert kann eine der folgenden VARIANT-Typen sein: VT_ARRAY|VT_UI1 (unformatierte Bytes), VT_BSTR (Zeichenfolge), VT_UI4 (ganze Zahl) oder VT_BOOL (Boolean).

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der Parameter "preferenceKey " oder "preferenceValue " ist NULL.
E_INVALIDARG 0x80000003	Der Parameter "preferenceKey " ist ungültig oder ist eine leere Zeichenfolge.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.
E_ACCESSDENIED 0x80070005	Der aktuelle Benutzer hat nicht genügend Zugriff auf die Konfigurationsdatei.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Der Prozessor unterstützt keine Hardware Accelerated Virtualization (HAV)-Erweiterungen.

Hinweise

Die folgenden Werte werden für den EinstellungKey-Parameter unterstützt.

preferenceKey-Wert	BESCHREIBUNG	Datentyp	Standardwert
"idle_timeout"	Die Anzahl der Sekunden, die vpc.exe warten sollten, bevor sie beendet werden, wenn keine aktiven VMs oder Anwendungen mit den Windows Virtual PC-Schnittstellen verwendet werden.	"ganze Zahl"	„30“

Diese Methode bietet Zugriff auf einen beliebigen Konfigurationswert auf niedriger Ebene. Es kann verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel festzulegen. Achten Sie darauf, wenn Sie diese Methode zum Festlegen von Systemkonfigurationswerten verwenden, da keine Fehlerüberprüfung für den Konfigurationswert ausgeführt wird. Außerdem können einige Konfigurationswerte nicht geändert werden, während ein virtueller Computer ausgeführt wird.

Konfigurationsschlüssel befinden sich im XML-Format der Datei "Options.xml" des virtuellen Computers. Die Schlüssel werden hierarchisch gespeichert, ähnlich wie die Registrierungsschlüssel in Windows. Um einen bestimmten Unterschlüssel anzugeben, wird ein "Schlüsselpfad" erstellt, der die verschiedenen Tasten in einem durch Trennzeichen getrennten Format angibt.

Um beispielsweise den Wert des Schlüssels "idle_timeout" festzulegen, der sich in der folgenden Schlüsselstruktur befindet:

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

Die einstellungKey-Pfadzeichenfolge würde wie folgt angegeben:

"idle_timeout"

Wenn eine der Schlüssel in der gewünschten Struktur einen Attributwert "id" aufweist, wird das Attribut und sein Wert unmittelbar nach dem zugeordneten Konfigurationsschlüssel mit dem folgenden klammerten Format in die EinstellungKey-Pfadzeichenfolge eingebettet: "[@id="id_value"]".

Um beispielsweise den Wert des "Golf"-Schlüssels festzulegen, der sich in der folgenden Schlüsselstruktur befindet:

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