IVMVirtualMachine::Name-Eigenschaft

  • Artikel

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

Ruft den Namen der VM-Konfiguration ab und legt den Namen fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_Name(
  [in]          BSTR virtualMachineName
);

HRESULT get_Name(
  [out, retval] BSTR *virtualMachineName
);

Eigenschaftswert

Gibt den Namen der VM-Konfiguration an. Die Länge des Namens darf nicht mehr als 80 Zeichen betragen, und die Gesamtlänge des vollqualifizierten Pfads, der die Konfigurationsdatei des VM-Namens enthält, darf nicht mehr als MAX_PATH (260) Zeichen sein.

Fehlercodes

Name/Wert Bedeutung
S_OK
0
 Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
 Der Parameter ist NULL.
E_INVALIDARG
0x80000003
 Der Parameter ist ungültig oder eine leere Zeichenfolge.
VM_E_VM_UNKNOWN
0xA0040207
 Die Konfiguration ist unbekannt.
VM_E_PREF_VM_ACTIVE
0xA0040302
 Der virtuelle Computer wird ausgeführt oder gespeichert.
VM_E_CONFIG_NO_NAME
0xA0040400
 Der parameter virtualMachineName ist leer.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
 Der Parameter enthält zu viele Zeichen.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 Der Parameter enthält eines der folgenden ungültigen Zeichen "*?::<>/|\"".
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Der angegebene Name ist bereits als Name eines anderen virtuellen Computers vorhanden.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Bei namen virtueller Computer wird die Groß-/Kleinschreibung nicht beachtet, z. B. "MyVM" und "myvm" verweisen auf denselben virtuellen Computer. Dies ist die Standardeigenschaft für IVMVirtualMachine.

Wenn VPC.exe ausgeführt wird und die VM gespeichert wird, ist das Festlegen der Name-Eigenschaft nicht erfolgreich. Wenn VPC.exe nicht ausgeführt wird und die VM gespeichert wird, wird die Eigenschaft Name beim nächsten Start VPC.exe erfolgreich festgelegt.

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