IVMVirtualPC::SetConfigurationValue-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr 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 verwendet wird, um die Einstellung zu identifizieren, wie sie in der Benutzerkonfigurationsdatei gespeichert ist (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 mithilfe 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_HARDWARE_VIRTUALIZATION_DISABLED
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
"idle_timeout"
 Anzahl der Sekunden, die vpc.exe warten sollten, bevor sie beendet werden, wenn keine aktiven VMs oder Anwendungen vorhanden sind, die die Windows Virtual PC-Schnittstellen verwenden.
 "ganze Zahl"
 „30“

Diese Methode ermöglicht den Zugriff auf einen beliebigen Konfigurationswert auf niedriger Ebene. Sie können verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel festzulegen. Gehen Sie vorsichtig vor, wenn Sie diese Methode verwenden, um Systemkonfigurationswerte festzulegen, da für den Konfigurationswert keine Fehlerüberprüfung durchgefü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 ähnlich wie die Registrierungsschlüssel in Windows hierarchisch gespeichert. Um einen bestimmten Unterschlüssel anzugeben, wird ein "Schlüsselpfad" erstellt, der die verschiedenen Schlüssel in einem durch Schrägstrich getrennten Format angibt.

So legen Sie beispielsweise den Wert des Schlüssels "idle_timeout" 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 den Attributwert "id" aufweist, werden das Attribut und sein Wert direkt nach dem zugeordneten Konfigurationsschlüssel in die pfadzeichenfolge preferenceKey eingebettet, wobei das folgende Klammerformat verwendet wird: "[@id="id_value"]".

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

<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)
 Windows 7 [nur 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 definiert als 236ba0d9-a24a-4292-a132-27c1421dfd01

Siehe auch

IVMVirtualPC

IVMVirtualMachine::SetConfigurationValue