IVMVirtualMachine::GetConfigurationValue-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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 In der Datei "*.vmc" gespeicherten Konfigurationswert zu identifizieren.

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 (Boolean).

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 configurationKey ist NULL oder leer.
E_POINTER
0x80004003
 Der parameter configurationValue 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. Es kann verwendet werden, um Konfigurationswerte für kundendefinierte Schlüssel zu lesen.

Konfigurationsschlüssel befinden sich in der Datei "*.vmc" des virtuellen Computers im XML-Format. Die Schlüssel werden ähnlich wie die Registrierungsschlüssel in Windows hierarchisch gespeichert. 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 lesen 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 Id-Attributwert 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 lesen 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

Weitere Informationen

IVMVirtualMachine