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
S _ OK
0
Der Vorgang wurde durchgeführt.
E _ INVALIDARG-0x80000003
Der configurationKey-Parameter ist NULL oder leer.
E _ ZEIGER 0X80004003
Der configurationValue-Parameter ist NULL.
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 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
VPCCOMInterfaces.h
IID
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert.

Siehe auch

IVMVirtualMachine