IVMVirtualMachine::RemoveConfigurationValue-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).]

Entfernt den Wert der angegebenen Konfigurationseinstellung für diesen virtuellen Computer.

Syntax

HRESULT RemoveConfigurationValue(
  [in] BSTR configurationKey
);

Parameter

configurationKey [ In]

Der Schlüssel, der verwendet wird, um den Konfigurationswert zu identifizieren, der in der * VMC-Datei gespeichert ist.

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 ist NULL oder leer.
VM _ E _ VM _ UNKNOWN
0xA0040207
Die Konfiguration ist unbekannt.
VM _ _E PREF _ NOT _ FOUND
0xA0040300
Die Einstellung wurde nicht gefunden.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Diese Methode bietet Zugriff auf einen beliebigen Konfigurationswert auf niedriger Ebene. Sie kann verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel zu entfernen. Gehen Sie vorsichtig vor, wenn Sie diese Methode verwenden, um Systemkonfigurationswerte zu entfernen, da einige Werte nicht geändert werden können, während der virtuelle Computer ausgeführt wird.

Konfigurationsschlüssel befinden sich in der VMC-Datei 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.

Um z. B. den Wert des _ Schlüssels "RAM-Größe" in der folgenden Schlüsselstruktur zu entfernen:

<hardware>
    <memory>
        <ram_size type="integer">128</ram_size>

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 configurationKey-Pfadzeichenfolge eingebettet, wobei das folgende format in Klammern verwendet wird: " [ @id =" id _ value" ] ".

Um z. B. den Wert des "absoluten" Schlüssels in der folgenden Schlüsselstruktur zu entfernen:

<hardware>
    <pci_bus>
        <ide_adapter>
            <ide_controller id="1">
                <location id="0">
                    <pathname>
                        <absolute type="string">D</absolute>

Die Pfadzeichenfolge configurationKey wird wie folgt angegeben:

"hardware/pci_bus/ide_adapter/ide_controller[@id=1]/location[@id=0]/pathname/absolute"

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
Product (Produkt)
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert.

Weitere Informationen

IVMVirtualMachine