IVMVirtualPC::UnregisterVirtualMachine-Methode

  • Artikel

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

Hebt die Registrierung einer VM-Konfiguration auf, ohne die Konfigurationsdatei zu löschen.

Syntax

HRESULT UnregisterVirtualMachine(
  [in] IVMVirtualMachine *virtualMachine
);

Parameter

virtualMachine [in]

Ein Zeiger auf ein IVMVirtualMachine-Objekt , das die VM-Konfiguration darstellt, die nicht registriert werden soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
 Der virtualMachine-Parameter war NULL.
VM_E_VM_RUNNING
0xA0040500
 Der virtuelle Computer wird ausgeführt.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Hardwarebeschleunigte Virtualisierungserweiterungen (HAV) werden vom Prozessor nicht unterstützt.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Nur beendete VMs können die Registrierung aufheben. Vorhandene gespeicherte Zustands- oder Rückgängiglaufwerksdaten für diese Konfiguration werden beibehalten, wenn eine VM nicht registriert wird.

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_IVMVirtualPC ist definiert als 236ba0d9-a24a-4292-a132-27c1421dfd01

Siehe auch

IVMVirtualPC