IVMVirtualPC::SetConfigurationValue-Methode

[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung 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 an Options.xml sollten 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 einer der folgenden VARIANT-Typen sein: VT _ ARRAY | VT _ UI1 (unformatierte Bytes), VT _ BSTR (Zeichenfolge), VT _ UI4 (integer) 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 preferenceKey- oder preferenceValue-Parameter ist NULL.
E _ INVALIDARG
0x80000003
Der preferenceKey-Parameter ist ungültig oder 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 _ _ HARDWAREVIRTUALISIERUNG _ DEAKTIVIERT
0xA0040951
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).

Bemerkungen

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

preferenceKey-Wert BESCHREIBUNG Datentyp Standardwert
_"Leerlauftimeout"
Anzahl von Sekunden, die vpc.exe warten sollten, bevor sie beendet werden, wenn keine aktiven VMs oder Anwendungen vorhanden sind, die die Windows Virtual PC Interfacesverwenden.
"integer"
„30“

Diese Methode bietet Zugriff auf einen beliebigen Konfigurationswert auf niedriger Ebene. Sie kann verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel festzulegen. Seien Sie vorsichtig, wenn Sie diese Methode verwenden, um Systemkonfigurationswerte festzulegen, 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 in der Datei "Options.xml" des virtuellen Computers im XML-Format. Die Schlüssel werden auf hierarchische Weise gespeichert, ähnlich wie die Registrierungsschlüssel in Windows. Um einen bestimmten Unterschlüssel anzugeben, wird ein "Schlüsselpfad" erstellt, der die verschiedenen Schlüssel in einem durch Schrägstriche getrennten Format angibt.

So legen Sie beispielsweise den Wert des _ Schlüssels "Leerlauftimeout" fest, der sich in der folgenden Schlüsselstruktur befindet:

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

Die Pfadzeichenfolge preferenceKey wird wie folgt angegeben:

"idle_timeout"

Wenn einer der Schlüssel in der gewünschten Struktur über einen ID-Attributwert verfügt, werden das Attribut und sein Wert unmittelbar nach dem zugeordneten Konfigurationsschlüssel in die preferenceKey-Pfadzeichenfolge eingebettet, wobei das folgende formatierte Format in Klammern verwendet wird: " [ @id ="id _ value" ] ".

So legen Sie z. B. den Wert des Schlüssels "soll" in der folgenden Schlüsselstruktur fest:

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

Die Pfadzeichenfolge preferenceKey wird wie folgt angegeben:

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Produkt
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC

IVMVirtualMachine::SetConfigurationValue