IVMVirtualMachine::GetConfigurationValue-Methode
[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]
Ruft den Wert der angegebenen Konfigurationseinstellung für diesen virtuellen Computer ab.
Syntax
HRESULT GetConfigurationValue(
[in] BSTR configurationKey,
[out, retval] VARIANT *configurationValue
);
Parameter
-
configurationKey [ In]
-
Der Schlüssel, der verwendet wird, um den Konfigurationswert zu identifizieren, der in der * VMC-Datei gespeichert ist.
-
configurationValue [ out, retval]
-
Der Konfigurationswert. Dieser Wert kann einer der folgenden VARIANT-Typen sein: VT _ ARRAY | VT _ UI1 (unformatierte Bytes), VT _ BSTR (Zeichenfolge), VT _ I4 (integer) oder VT _ BOOL (boolescher Wert).
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der configurationKey-Parameter ist NULL oder leer. |
|
Der configurationValue-Parameter ist NULL. |
|
Die Konfiguration ist unbekannt. |
|
Die Einstellung wurde nicht gefunden. |
|
Ein unerwarteter Fehler ist aufgetreten. |
Bemerkungen
Diese Methode ermöglicht den Zugriff auf einen beliebigen Konfigurationswert auf niedriger Ebene. Sie kann verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel zu lesen.
Konfigurationsschlüssel befinden sich in der VMC-Datei des virtuellen * Computers im XML-Format. Die Schlüssel werden in einer hierarchischen Weise gespeichert, die den Registrierungsschlüsseln in der 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.
Um beispielsweise den Wert des Schlüssels _ "RAM-Größe" in der folgenden Schlüsselstruktur zu lesen:
<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 einen "id"-Attributwert hat, werden das Attribut und sein Wert unmittelbar nach dem zugehörigen Konfigurationsschlüssel in die Pfadzeichenfolge configurationKey eingebettet. Verwenden Sie dabei das folgende Format in Klammern: " [ @id ="id _ value" ] ".
Um beispielsweise den Wert des "absoluten" Schlüssels zu lesen, 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 [ Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Ende des Supports (Client) |
Windows 7 |
| Produkt |
Windows Virtual PC |
| Header |
|
| IID |
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert. |