IVMVirtualMachine::RemoveConfigurationValue-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr 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 zum Identifizieren des Konfigurationswerts verwendet wird, der in der Datei "*.vmc" 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.

Bemerkungen

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 zu entfernen. Seien Sie vorsichtig, 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 Datei "*.vmc" des virtuellen Computers im XML-Format. Die Schlüssel werden hierarchisch gespeichert, ähnlich den Registrierungsschlüsseln in Windows. 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 entfernen Sie beispielsweise den Wert des Schlüssels "ram_size", der sich in der folgenden Schlüsselstruktur befindet:

<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 Attributwert "id" 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 entfernen Sie beispielsweise den Wert des "absoluten" Schlüssels, der sich in der folgenden Schlüsselstruktur befindet:

<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)	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