IVMVirtualMachine::GetActivationValue-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 Aktivierungseinstellung für diesen virtuellen Computer ab.

Syntax

HRESULT GetActivationValue(
  [in]          BSTR    activationKey,
  [out, retval] VARIANT *activationValue
);

Parameter

activationKey [in]

Der Schlüssel, der verwendet wird, um den Aktivierungswert zu identifizieren, der in der Datei "*.vmc" gespeichert ist.

activationValue [out, retval]

Der Aktivierungswert. 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 aktivierungKey-Parameter ist NULL oder leer.
E_POINTER
0x80004003
 Der aktivierungValue-Parameter ist NULL.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
VM_E_PREF_NOT_FOUND
0xA0040300
 Die Einstellung wurde nicht gefunden, oder diese Konfiguration hat keine gültige Aktivierung.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Diese Methode ermöglicht den Zugriff auf einen beliebigen Aktivierungswert auf niedriger Ebene. Sie können verwendet werden, um Aktivierungswerte für kundendefinierte Schlüssel festzulegen. Wenn ein virtueller Computer gestartet wird, wird eine Kopie seiner Konfigurationswerte erstellt, die zu seinem Satz von Aktivierungswerten werden. Aktivierungswerte werden beibehalten, bis der virtuelle Computer heruntergefahren oder neu gestartet wird. Beachten Sie, dass Windows Virtual PC die Konfiguration möglicherweise nur zum Speichern von Werten für bestimmte Schlüssel verwenden kann, d. h. der Aktivierungswert wird möglicherweise nie verwendet.

Aktivierungsschlüssel werden intern hierarchisch gespeichert, ähnlich den Registrierungsschlüsseln in 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.

So lesen Sie beispielsweise den Wert des Schlüssels "default_action", der sich in der folgenden Schlüsselstruktur befindet:

<settings>
    <undo_drives>
        <default_action type="integer">1</default_action>

Die pfadzeichenfolge activationKey wird wie folgt angegeben:

"settings/undo_drives/default_action"

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

Siehe auch

IVMVirtualMachine