IVMVirtualMachine::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 für diesen virtuellen Computer (VM) fest.

Syntax

HRESULT SetConfigurationValue(
  [in] BSTR    configurationKey,
  [in] VARIANT configurationValue
);

Parameter

configurationKey [in]

Der Schlüssel, der verwendet wird, um den In der Datei "*.vmc" gespeicherten Konfigurationswert zu identifizieren.

Wichtig

Änderungen an "*.vmc" sollten nur mithilfe der SetConfigurationValue-Methode vorgenommen werden. Das Ändern von "*.vmc" mithilfe einer anderen Methode wird nicht unterstützt.

configurationValue [in]

Der Konfigurationswert. Dieser Wert ist einer der folgenden VARIANT-Typen : 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_INVALIDARG
0x80000003
 Der parameter configurationKey ist NULL oder leer, oder der parameter configurationValue ist kein gültiger Varianttyp.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die folgenden Werte werden für den parameter configurationKey unterstützt.

configurationKey-Wert BESCHREIBUNG Datentyp Standardwert
"hardware/bios/time_sync_at_boot"
 "true", wenn die VM-CMOS-Uhr beim Start mit der Hostuhr synchronisiert werden soll; Andernfalls "false".
 "boolean"
 "true"
"integration/microsoft/host_time_sync/enabled""
 "true", wenn die Hostzeitsynchronisierung in den Integrationskomponenten aktiviert ist; Andernfalls "false".
 "boolean"
 "true"
"ui_options/auto_app_publish"
 "true", wenn die automatische Veröffentlichung von Anwendungen in den Integrationskomponenten aktiviert ist; Andernfalls "false". Dies wird auch als virtuelle Anwendungen bezeichnet.
 "boolean"
 "true"
"ui_options/seconds_to_save"
 Anzahl der Sekunden, die vor dem Speichern des virtuellen Computers gewartet werden sollen, nachdem alle Anwendungen geschlossen wurden. Werte unter 20 und mehr als 4.294.968 haben jedoch eine besondere Bedeutung. Weitere Informationen finden Sie in der folgenden Liste.
0
Speichern Sie den virtuellen Computer niemals.
1 20
Warten Sie 20 Sekunden, bevor Sie die VM speichern.
21 4,294,967
Warten Sie die angegebene Anzahl von Sekunden, bevor Sie den virtuellen Computer speichern.
4,294,968 4,294,967,295
Warten Sie 4.294.968 Sekunden, bevor Sie die VM speichern.
 "ganze Zahl"
 300

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 der virtuelle Computer ausgeführt wird.

Konfigurationsschlüssel befinden sich in der Datei "*.vmc" 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 "ram_size" fest, der sich in der folgenden Schlüsselstruktur befindet:

<preferences>
  <hardware>
    <bios>
      <time_sync_at_boot type="boolean">true</time_sync_at_boot>

Die pfadzeichenfolge configurationKey wird wie folgt angegeben:

"hardware/memory/ram_size"

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 pfadzeichenfolge configurationKey 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 configurationKey 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_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Siehe auch

IVMVirtualMachine

IVMVirtualPC::SetConfigurationValue