IVMVirtualMachine::SetActivationValue-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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, wie er in der Datei "*.vmc" 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 (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 activationKey ist NULL oder leer, oder der parameter activationValue ist kein gültiger Varianttyp.
VM_E_VM_UNKNOWN 0xA0040207	Die Konfiguration ist unbekannt.
VM_E_PREF_NOT_FOUND 0xA0040300	Die 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. Es kann verwendet werden, um Aktivierungswerte für kundendefinierte Schlüssel festzulegen. Seien Sie vorsichtig, wenn Sie diese Methode verwenden, um Systemaktivierungswerte festzulegen, da keine Fehlerüberprüfung für den Aktivierungswert durchgefü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 der Konfigurationswerte erstellt, die zu einem Satz von Aktivierungswerten werden. Aktivierungswerte werden beibehalten, bis der virtuelle Computer heruntergefahren oder neu gestartet wird. Beachten Sie, dass Windows Virtual PC die Konfiguration nur verwenden kann, um Werte für bestimmte Schlüssel zu speichern, d. h. der Aktivierungswert wird möglicherweise nie verwendet.

Hinweis

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

Aktivierungsschlüssel werden intern auf eine hierarchische Weise gespeichert, die den Registrierungsschlüsseln in Windows ähnelt. 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 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