IVMVirtualMachine::Name-Eigenschaft

Artikel
06/13/2023

[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

Teilen über