IVMVirtualPC::GetConfigurationValue-Methode

[Windows Virtual PC ist nicht mehr für die Verwendung als Windows 8 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 verwendet wird, um die Einstellung zu identifizieren, wie in der Konfigurationsdatei gespeichert.

preferenceValue [out, retval]

Der Einstellungswert. Dieser Parameter kann eine der folgenden VARIANT-Typen sein: VT_ARRAY|VT_UI1 (unformatierte Bytes), VT_BSTR (Zeichenfolge), VT_I4 (ganze Zahl) 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 Parameter "preferenceKey " oder "preferenceValue " ist NULL.
VM_E_PREF_NOT_FOUND
0xa0040300
Die Einstellung wurde nicht gefunden.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
Der Prozessor unterstützt keine Hardware Accelerated Virtualization (HAV)-Erweiterungen.
DISP_E_EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

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

Requirements (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_IVMVirtualPC wird als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC