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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der activationKey-Parameter ist NULL oder leer, oder der activationValue-Parameter ist kein gültiger Variantentyp. |
|
Die Konfiguration ist unbekannt. |
|
Die Konfiguration verfügt über keine gültige Aktivierung. |
|
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 |
|
| IID |
IID _ IVMVirtualMachine ist als f7092aa1-33ed-4f78-a59f-c00adfc2edd7 definiert. |