IVMVirtualMachine::RemoveActivationValue-Methode

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

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

Syntax

HRESULT RemoveActivationValue(
  [in] BSTR activationKey
);

Parameter

activationKey [in]

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

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 ist NULL oder leer.
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. Es kann verwendet werden, um Aktivierungswerte für kundendefinierte Schlüssel zu entfernen. Seien Sie vorsichtig, wenn Sie diese Methode verwenden, um Systemaktivierungswerte zu entfernen, da einige Werte nicht geändert werden können, 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 entfernen 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