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.
HRESULT RemoveConfigurationValue(
[in] BSTR configurationKey
);
-
configurationKey [in]
-
Der Schlüssel, der zum Identifizieren des Konfigurationswerts verwendet wird, der in der Datei "*.vmc" gespeichert ist.
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. |
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"
| 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 |
|
| IID |
IID_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |