IVMVirtualMachine::SetActivationValue-Methode

[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Legt den Wert der angegebenen Aktivierungseinstellung für diesen virtuellen Computer fest.

Syntax

HRESULT SetActivationValue(
  [in] BSTR    activationKey,
  [in] VARIANT activationValue
);

Parameter

activationKey [ In]

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

activationValue [ In]

Der Aktivierungswert. Dieser Wert kann einer der folgenden VARIANT-Typen sein: VT _ ARRAY | VT _ UI1 (unformatierte Bytes), VT _ BSTR (Zeichenfolge), VT _ UI4 (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 activationKey-Parameter ist NULL oder leer, oder der activationValue-Parameter ist kein gültiger Variantentyp.
VM _ E _ VM _ UNKNOWN
0xA0040207
Die Konfiguration ist unbekannt.
VM _ E _ PREF _ NOT _ FOUND
0xA0040300
Die Konfiguration verfügt über keine gültige Aktivierung.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Diese Methode ermöglicht den Zugriff auf einen beliebigen Aktivierungswert auf niedriger Ebene. Sie kann verwendet werden, um Aktivierungswerte für kundendefinierte Schlüssel festzulegen. Seien Sie vorsichtig, wenn Sie diese Methode zum Festlegen von Systemaktivierungswerten verwenden, da keine Fehlerüberprüfung für den Aktivierungswert ausgeführt wird. Außerdem können einige Aktivierungswerte nicht geändert werden, während der virtuelle Computer ausgeführt wird. Wenn ein virtueller Computer gestartet wird, wird eine Kopie seiner Konfigurationswerte vorgenommen, die zu einem Satz von Aktivierungswerten wird. Aktivierungswerte werden beibehalten, bis der virtuelle Computer heruntergefahren oder neu gestartet wird. Beachten Sie, Windows virtueller PC die Konfiguration nur zum Speichern von Werten für bestimmte Schlüssel verwenden darf, d.&Windows der Aktivierungswert möglicherweise nie verwendet wird.

Hinweis

Die Sitzung des virtuellen Computers muss ausgeführt werden, bevor Aktivierungswerte geändert werden können.

Aktivierungsschlüssel werden intern in einer hierarchischen Weise gespeichert, ähnlich wie die Registrierungsschlüssel 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 legen Sie beispielsweise den Wert des Schlüssels "Default _ Action" fest, der sich in der folgenden Schlüsselstruktur befindet:

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

Die ActivationKey-Pfadzeichenfolge wird wie folgt angegeben:

"settings/undo_drives/default_action"

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Product (Produkt)
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert.

Siehe auch

IVMVirtualMachine