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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Parameter ist NULL oder leer. |
|
Die Konfiguration ist unbekannt. |
|
Die Einstellung wurde nicht gefunden. |
|
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 |
|
| IID |
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert. |