IVMVirtualPC::GetConfigurationValue-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).]

Ruft den Wert der angegebenen Konfigurationseinstellung ab

Syntax

HRESULT GetConfigurationValue(
  [in]          BSTR    preferenceKey,
  [out, retval] VARIANT *preferenceValue
);

Parameter

preferenceKey [ In]

Der Schlüssel, der zum Identifizieren der Einstellung verwendet wird, wie in der Konfigurationsdatei gespeichert.

preferenceValue [ out, retval]

Der Einstellungswert. Dieser Parameter 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 _ POINTER
0x80004003
Der preferenceKey- oder preferenceValue-Parameter ist NULL.
VM _ _E PREF _ NOT _ FOUND
0xa0040300
Die Einstellung wurde nicht gefunden.
VM _ E _ _ HARDWAREVIRTUALISIERUNG _ DEAKTIVIERT
0xA0040951
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Diese Methode bietet Zugriff auf einen beliebigen Einstellungswert für den aktuellen Benutzer auf niedriger Ebene. Sie kann verwendet werden, um Einstellungswerte für kundendefinierte Schlüssel abzurufen.

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
Produkt
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC