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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der preferenceKey- oder preferenceValue-Parameter ist NULL. |
|
Der preferenceKey-Parameter ist ungültig oder eine leere Zeichenfolge. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der aktuelle Benutzer hat nicht genügend Zugriff auf die Konfigurationsdatei. |
|
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 |
|
| IID |
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert. |